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PACKAGE, ITS MERCHANTABILITY OR ITS FITNESS FOR ANY 
PARTICULAR PURPOSE. THE EXCLUSION OF IMPLIED WARRANTIES 
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MA Y NOT APPLY TO YOU. THIS WARRANTY PROVIDES YOU WITH 
SPECIFIC LEGAL RIGHTS. THERE MAY BE OTHER RIGHTS THAT 
YOU MAY HAVE WHICH VARY FROM STATE TO STATE. 



And now on with our program! 



First, our legal stuff... 



ROGER WAGNER PUBLISHING, INC. 

CUSTOMER LICENSE AGREEMENT 

IMPORTANT: The Roger Wagner Publishing, Inc. software 
product that you have just received from Roger Wagner 
Publishing, Inc., or one of its authorized dealers, is 
provided to you subject to the Terms and Conditions of 
this Software Customer License Agreement. Should you 
decide that you cannot accept these Terms and Condi- 
tions, then you must return your product with all docu- 
mentation and this License marked "REFUSED" within the 
30 day examination period following the receipt of the 
product. 

1. License. Roger Wagner Publishing, Inc. hereby 
grants you upon your receipt of this product, a 
nonexclusive license to use the enclosed Roger Wagner 
Publishing, Inc. product subject to the terms and 
restrictions set forth in this License Agreement. 

2. Copyright. This software product, and its 
documentation, is copyrighted by Roger Wagner Publish- 
ing, Inc. You may not copy or otherwise reproduce the 
product or any part of it except as expressly permitted 
in this License. 

3. Restrictions on Use and Transfer. The original and 
any backup copies of this product are intended for your 
personal use in connection with a single computer. You 
may not distribute copies of, or any part of, this 
product without the express written permission of 
Roger Wagner Publishing, Inc. 



LIMITATION ON WARRANTIES AND LIABILITY 

ROGER WAGNER PUBLISHING, INC. AND THE PROGRAM AUTHOR 
SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO PURCHASER 
OR ANY OTHER PERSON OR ENTITY WITH RESPECT TO ANY 
LIABILITY, LOSS OR DAMAGE CAUSED OR ALLEGED TO BE CAUSED 
DIRECTLY OR INDIRECTLY BY THIS SOFTWARE, INCLUDING, BUT 
NOT LIMITED TO ANY INTERRUPTION OF SERVICE, LOSS OF 
BUSINESS OR ANTICIPATORY PROFITS OR CONSEQUENTIAL 
DAMAGES RESULTING FROM THE USE OR OPERATION OF THIS 
SOFTWARE. SOME STATES DO NOT ALLOW THE EXCLUSION OR 
LIMITATION OF IMPLIED WARRANTIES OR LIABILITY FOR 
INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE 
LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. 
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THE INTERRUPT EXPERIMENTERS' S KIT 
By Dan Fischer, Morgan P. Caffrey and Roger Wagner 

INTRODUCTION 



Computers are dumb, unimaginative, critters. They do as 
they are told, no more, no less. They follow a list of 
instructions, from the first to the last, without devia- 
tion. Of course the program instruction itself may 
change the sequence but that is just part of following 
ins truct ions . 

However, as with everything else in this inconsistent 
world, there are exceptions. Resets and power failures 
are traumatic events in the life of an executing pro- 
gram. They interrupt the flow of the program. Actually 
they don't interrupt it as much as they terminate it. 
They interrupt a program much as a speeding truck might 
interrupt the life of a lazy skunk. The interrupt never 
end s . 

"Interrupt” implies a temporary condition. There are 
ways to interrupt a program's flow, without the 
program's “knowledge" or control, and without inter- 
fering with the logical process of the program. These 
interrupts require hardware however, and software smart 
enough to recognize the situation and handle it 
appropriately . 

There are two hardware signals within the APPLE which 
cause the Apple's microprocessor, hereinafter referred 
to as the "6502," to save its place in one program and 
go off and execute another program. This interrupt 
service program can return control to the original 
program is such a way that the original program won't 
even know that it has been interrupted. 

Suppose you are talking to someone on the phone when the 
doorbell rings. You excuse yourself from the phone, 
take care of the person at the door, and return to the 
phone to finish telling your neighbor about the latest 
sale of minis and micros. If you handled the door 
interrupt well you will pick up your story where you 
left off and your listener will follow right along 
without any "What was that?"s or "Would you start over?" 

If, however, the person at the door happens to be the 
Grim Reaper, here to take you to the Promised Land, you 
will never return to your 'interrupted' conversation. 
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Resets and power failures are like the Grim Reaper, 
programs never return . 

When the APPLE is prepared to handle interrupts, it is 
prepared to run two separate programs at once (at least 
in outward appearance). Let s refer to the original 
program, the one that gets interrupted, as the 'fore- 
ground" task and to the program that gets run by the 
interrupt as the "background" task. From the user's 
standpoint both programs are running at the same time. 
From the 6502"s standpoint it always executes instruc- 
tions one after the other, never two at once. 

Although it is almost commonplace to say it, micropro- 
cessors are FAST. Running two programs at once, 
performing very simple to very complex functions, can 
happen without the user even being aware of the 
slightest slowdown. In the Apple II it is possible to 
run a 300 character-per-second printer (listing a text 
file from disk) at the exact same time you are entering 
data into your word processor. 

The foreground task doesn't "know” about the background 
task. It doesn't have to consider it at all. It may 
freely treat the computer as its private resource 
(although space must be reserved for the background 
program to exist). 

On the other hand, the background task must be polite. 
It must consider the foreground task and not do anything 
to interfere with the foreground task. It must be more 
polite than the environmentalist in the forest. You 
know, the one who takes only pictures and leaves only 
footprints. The background program must not leave 
footprints. Leaving even the slightest footprint on a 
computer program has a tendency to scramble your screen 
designs and do odd kinds of rounding to your numbers. 

I can hear you asking "If it's all so complicated why 
even do foreground/ background stuff at all? Why not 
just let well enough alone and let the APPLE do its 
thing with a single program?" You can do that. You 
usually do. But there are times when you could set your 
APPLE to doing a task for you and it probably has time 
left over to do another task. 



USING A CLOCK 

For example, if you have a clock card in your APPLE you 
might want to display the time on the screen and update 
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the time every second or every minute. It would be a 
terrible waste of the APPLE'S capability to use it for a 
clock to the exclusion of anything else. 

Using interrupts you can set the background task to 
updating the screen clock and leave the foreground task 
to do the work at hand. The amount of time used each 
second to perform such a task is a mere fraction of one 
percent of the available processing time each second. 



PRINTING and PROGRAMMING 

Or maybe you get bored waiting for your printer to 
finish printing. In a way so does your APPLE. It is 
waiting for your printer about 96% of the time when it 
is printing. That's time you could be using your APPLE 
for something else if you had a way for the printer to 
tell the APPLE when it is ready for another character. 

One solution for this problem is to buy a buffer card (a 
smart bucket of RAM, Random Access Memory, cells) and 
have the hardware quickly gulp characters destined for 
the printer and feed them out one at a time to the 
printer. This can be an expensive proposition and can't 
handle documents much larger than the bucket. When the 
bucket fills you wait anyway, although not for as long 
overall as you would have without it. 

Another method is to dedicate a small portion of your 
computer's memory to the task of handling the printer in 
background mode. Much less expensive. And it can be 
made to work at many more problems than just printing. 

Now let's get a little technical. There are two types 
of interrupts in the APPLE. They are called IRQ and 
NMI . The NMI is the "non-maskable interrupt”. You 
probably guessed that the IRQ is a "maskable" interrupt. 

Whenever a non-maskable interrupt occurs the 6502 will 
process it. Nothing will keep it from doing so. The 
presence of the physical interrupting signal cannot be 
masked off from the 6502. The RESET key works in a 
similar way. When you press RESET, the Apple must stop 
whatever it is doing to process the RESET command. 

The APPLE is constructed in such a way that there are 
times when it performs tasks that are time-dependent. 
In feeding data to the disk drive the 6502 is used as a 
timer. Its cyles are like the ticks (or tocks, if you 
prefer) of a software clock. 
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If a non-maskable interrupt were to occur while you were 
w£2.£i.ng a sector to the disk the diskette s data 
integrity would be destroyed. The NMI is sufficiently 
dangerous that we don't recommend using it. 

The IRQ, however, is a quite manageable beast. IRQ 
stands for Interrupt ReQuest. When a hardware device 
senses a condition for which it is supposed to generate 
an interrupt it pulls the line called IRQ low (lowers 
the voltage). The 6502, if its program has told it to 
honor interrupt requests, responds by saving its place 
in the program it is executing and begins to execute the 
background interrupt program. When the interrupt 
routine is finished executing it points the 6502 back to 
where it was before it was interrupted and returns 
control back to the foreground task. 



HOW AN INTERRUPT IS PROCESSED 

"How does it do all this?" you ask. Since interrupt 
service routines are invariably written in machine 
language, all future discussions will assume you know a 
least a little about assembly language programming. 
It's not required that you be an expert in this regard, 
but you should know the difference between a JSR and 
JMP ! 

If you don't have a background in this area, you might 
consider reading a book like "ASSEMBLY LINES: THE BOOK , 
Published by Roger Wagner Publishing as a good start to 
learning assembly language programming. Also, to create 
any of your own interrupt routines you'll need a good 
assembler such as the MERLIN assembler, also published 
by Roger Wagner Publishing. 



CLI, SEI, and RTI 

An interrupt causes what can be thought of as a "condi- 
tional JSR". It is conditional because the computer has 
the option of ignoring interrupt requests. 

As mentioned earlier, there are times, such as while 
writing to the disk, that an interrupt would produce 
very undesireable results. Therefore, two assembly 
language commands are provided to allow, or prevent, 
interrupt requests from being recognized. These are 
the CLI and SEI commands. 
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When you first turn on the Apple, one of the first 
machine language instructions executed is a SEI 
instruction. This stands for "Stop External Inter- 
rupts", and tells the 6502 to ignore any future 
interrupt requests. (Remember, RESET is not a request, 
it's a demand!). 

If you want to have the 6502 honor an interrupt request, 
then the instruction CLI (for Clear Interrupt mask) must 
be used. Once this is executed, the next interrupt 
request to come along will be honored. 

This is where the 'JSR' part of the 'conditional JSR' 
concept comes in. When an interrupt request does come 
along, the 6502 will do something very much like a JSR 
to a routine of your chosing at that point. This is 
also why interrupt routines must be written with a 
certain amount of care. Because the JSR— like operation 
can occur at almost any time , your interrupt routine 
must restore any registers or other important memory 
locations it has altered before it returns to the 
normally running foreground program. 

What this usually means is that you must deliberately 
save the Accumulator and X and Y registers, and then 
restore them when your routine is ready to return to 
the foreground program. 

How is the pseudo-JSR done? Because it can be triggered 
at almost any location in your foreground program, there 
is no equivalent command to the JSR that you're already 
familiar with. Instead, the hardware that generates the 
interrupt works hand in hand with the 6502 to break 
program execution away from the foreground program to go 
to the background interrupt routine. 

Once your interrupt routine has control, no future 
interrupt requests can "re-interrupt" things until you 
return to the foreground program. When you are ready 
to return, you use the instruction RTI (for Return 
from Interrupt) to return to the foreground program. 

WHERE DO INTERRUPTS THEMSELVES COME FROM? 

So far we've given a general picture of how interrupts 
are handled, but where do IRQ's, interrupt requests, 
come from in the first place? 

An interrupt is generated by changing the voltage on the 
Apple's 'bus'. The bus is a term that refers to the 
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collection of wires that run through the system that 
carry signals telling the 6502 what address is being 
accessed and other interesting information. 

These lines are most visible as the slots into which 
peripheral cards are plugged. Each connector on a 
peripheral card attaches to a wire that makes up the 
lines of the bus. Two of these wires are the NMI and 
IRQ lines. Ordinarily, nothing is hooked up to either 
of these lines. 

That's where The Interrupt Experimenter's Kit comes in. 
The Apple as shipped doesn't have anything provided to 
generate interrupts, and that's why so few people are 
familiar with how to use them. When you plug the 
circuit card that's included in The Interrupt Experi- 
menter's Kit (the Interrupt Source Card) into slot #4 of 
your Apple, you are attaching some special circuitry 
which will generate interrupts on the Apple's IRQ line, 
which will then allow you to experiment with your own 
interrupt routines. 

The question now becomes, how do you turn the interrupts 
generated by the card on and off? 

The card that is provided with this package produces 
interrupts at a regular rate of about 250 interrupts 
per second. The card is activated by accessing a 
special memory location in the Apple. It happens that 
the Apple is set up so that each peripheral slot has 
16 bytes of memory set aside for it in the general area 
of $C080 to $ COFF . To determine which block of memory 
is available to a given slot, you just add the slot 
number to '8' in the address. For example, for slot #4, 
the memory range is $C0(8+4)0 to $C0(8+4)F, or specif- 
ically, $C0C0 to $C0CF. Any BASIC or machine language 
instruction (such as PEEK, POKE, LDA, STA or BIT) that 
references any address in the range of $C0C0 to $C0CF 
will turn on the interrupts on the card. 

Remember, these are interrupt requests (IRQ's), and 
nothing will happen unless a CLI instruction is also 
executed at some point. 

To turn off the card, you must access the address space 
allocated for the card itself (256 bytes this time), 
which is $C(N)00 through $C(N)FF. Thus for slot #4, 
accessing any address from $C400 to $C4FF would turn off 
the card. Generally, you should also remember to 
execute an SEI to disable interrupts, but this may 
depend on your application. 
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The card can also be turned off by hitting RESET, but 
this does not perform the SEI to disable interrupts at 
the 6502 level, so keep this in mind. Also remember 
that DOS automatically does an SEI to disable interrupts 
when either reading or writing to the disk, but it will 
restore the existing condition (interrupts enabled or 
disabled) when it's done. You'll notice this in any of 
the demos in this package if you CATALOG a disk while a 
demo is running. The demo will stop during the CATALOG, 
but resume when the disk turns off. 



WHAT HAPPENS DURING AN INTERRUPT 

Now that we know the Apple at least has the capacity to 
handle interrupts, and we've provided a way to generate 
them, let's look at what's necessary to set up an 
interrupt routine, and what actually happens when an 
interrupt comes along. 

THE INTERRUPT VECTOR 

Before letting interrupts loose in the system, the 
first thing we have to do is to tell the Apple what to 
do with them when they happen. This means we've got to 
tell the computer where our interrupt handling 
routine will be located in memory. 

This is done by means of the 'interrupt vector'. A 
vector is simply a pair of bytes somewhere in the 
computer that holds the address of some other location. 
In this case, the vector we're concerned with are the 
bytes $3FE and $3FF. These two bytes point at where 
the 6502 should go to when an interrupt comes along. 

If we wanted to put our own routine starting at 
location $300 for example, we would put a '$00' at $3FE 
and a '$03' at $3FF. 

Once this is done, (and our routine is loaded at $300), 
we can safely enable interrupts with the CLI command, 
and then turn on the interrupt card. Assuming this much 
has happened, let's see what happens when the first 
interrupt occurs. 
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When an interrupt occurs, the first thing that happens 
is that the 6502 saves the address of where it's 
currently at in the foreground program. This is so that 
it will be able to resume where it left off when the 
interrupt routine is finished. It does this by pushing 
the values in something called the Program Counter (also 
called the PC register) onto the stack. The Program 
Counter is a register inside the 6502, sort of like the 
Accumulator, except that it holds two bytes that point 
to where in a given program the 6502 is currently 
executing . 

After the Program Counter is saved, the Status Register 
is also pushed on the stack. Remember, the Status 
Register holds the results of comparisons, the overflow 
flag, the carry bit, and all sorts of other important 
information, so it's easy to see why this also gets 
saved right away. The IRQ bit in the Status Register 
is also set here to prevent further interrupts from 
effecting things until the end of the given interrupt 
routine, at which point interrupts will be re-enabled 
when the Status Register is restored. 

Once the most important things have been saved, the 6502 
then jumps to the address pointed to by the last two 
bytes of memory, $FFFE and FFFF. On most Apple II+, / / E 
and //c machines, this will point to $FA40. This is the 
Monitor's interrupt routine, where the real software 
handling of the interrupt starts. 



Let's 


look at the 


code 


at $FA40 


to see what happens 


her e . 


Go into 


the 


Monitor 


by typing CALL -151 


from 


Applesoft. Then 


type 


in FA40L. 


You should get: 




FA40- 


85 45 


STA 


$45 


; save Acc. 




FA42- 


68 


PLA 




; retrieve Status 


Reg . 


FA43- 


48 


PHA 




; copy Status to 


s tack 


FA44- 


0A 


ASL 








FA45- 


0A 


ASL 








FA46- 


0A 


ASL 




; shift int fig to N 


FA47- 


30 03 


BMI 


$FA4C 


; branch if BRK. 




FA49- 


6C FE 03 


JMP 


( $3FE) 


; JMP via vector 





The comments on the right are shown here to help explain 
what's going on, and won't be displayed on your screen. 

Since this routine is about to use the Accumulator to 
do some testing, it first saves the contents of the 
Accumulator in location $45. This is important to you 
because you will have to use the contents of $45 later 
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at the end of your routine to restore the Accumulator 
before doing the RTI to restore everything properly. 

The next thing that happens is that the Status Register 
is pulled off the stack and then recopied back onto it. 
The net effect here is that the stack is unchanged, but 
there is now a copy of the Status Register in the 
Acuumulato r . This is because the routine wants to 
determine whether an interrupt or a BRK instruction has 
occurred. The BRK instruction is handled by this same 
part of the Monitor. The distinction is made by 
examining bit 4 of the Status Register. If it's set, a 
BRK (Break) instruction has occurred. If clear, it's an 
interrupt . 

It takes three ASL's (Arithmetic Shift Left) to put bit 
4 into the N (negative/ positive) flag of the Status 
Register, at which point the BMI is used to test it. If 
a BRK has happened, it branches to the BREAK routine at 
$ F A4 C . If (as we would hope) it is an interrupt, it 
jumps to the part of memory pointed to by the bytes at 
$ 3FE and $3FF. (Aren't you glad you set this up ahead of 
time? Imagine where it might go if $3FE,3FF were random 
values ! ) 

It is at this point that your interrupt routine gains 
control . 

You might hink that the most trivial interrupt routine 
would be just a single RTI. This is factually true, but 
does not work when implemented. That's because you have 
to remember to restore the Accumulator before the RTI. 
Thus, the simplest wo rking routine is: 

$0300- A5 45 LDA $45 ; restore Acc. 

$0302- 40 RTI ; return to program 

With the Accumulator restored, when the RTI is executed 
it first restores the Status Register by pulling a value 
back off of the stack. This also has the effect of 
re-enabling interrupts (remember CLI clears bit 3 of the 
Status Register to enable interrupts). Next the 
Program Counter is restored with another two pulls. It 
then returns to the foreground program that was running 
when the interrupt first occurred. 

Another way of looking at the complete process is to 
say that when an interrupt occurs, the equivalent of 
the following occurs: 
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STA $45 
LDA PC 
PHA 

LDA PC+1 
PHA 



Save Accumulator. 

Not possible, but the idea of it. 
Put the low byte of PC on stack. 

Put high byte of PC on stack. 



PHP 

SEI 

JMP ( $ 3FE ) 



Put Status Register on stack. 
Protect from further interrupts. 
Jump to user's routine. 



When your program is finished, the RTI performs the 
equivalent of this: 

PLP ; Restore Status Register (= CLI) 

; You've already restored at least 
the Acc. haven't you? 

RTS ; Return to foreground program. 

(pulls PC, PC+1 off stack to do it) 



For those who are really deep thinking, it should also 
be obvious (because the system wouldn't work otherwise) 
that interupts are really excluded from the very 
beginning of the PC and Status Register save operations. 
That is to say, the 6502's interrupt handling during the 
first few cycles can't be reinterrupted. 



THE FIRST EXPERIMENT 



Now that we've covered the theory, let's try out your 
first interrupt experiment. Since we only need to 
change a few locations in memory, an Applesoft BASIC 
program will be a good way to set everything up. 

If you haven't done so already, turn off the power on 
your Apple, and install the Interrupt Source Card in 
slot #4 of your computer. Then replace the cover and 
re-boot on the Interrupt Experimenter's Kit diskette. 



You'll see a title page, and if you press a key, the 
disk will CATALOG and you'll get the Applesoft prompt 
(]). When you get the Applesoft prompt, type in NEW and 
then enter this program: 



0 REM INTERRUPT TEST PROGRAM 
5 PRINT CHR$ ( 7 ) : REM NORMAL BELL SOUND 

10 POKE 768,165: POKE 769,69: REM LDA $45 INSTR. 

REM RTI INSTRUCTION 
POKE 772,76: REM CLI, RTS INSTR. 
POKE 1015,3: REM ($3FE,3FF) = $300 



20 POKE 770,64 
30 POKE 771,88 



40 POKE 
50 CALL 77 




REM ENABLE INTERRUPTS 




Wb 
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f 413‘H J 

60 POKE 4 9 »~r9 r 0 : REM ACCESS $C0C0 TO TURN ON CARD 
70 PRINT CHR$ ( 7 ) : REM INT BELL SOUND 

When you RUN this program, you should first hear a 
beep, and then something that's more like a buzz than a 
beep • 

Let's look at the listing. Line 5 prints the Apple's 
'beep' character, Control-G. This is for comparison to 
the later sound. 

Lines 10 and 20 POKE into memory, starting at location 
$300, the values for the following machine language 
program : 

0300- A5 45 LDA $45 

0302- 40 RTI 

This iwill be our trivial interrupt routine. Line 30 
creates a short program that will enable interrupts. 
It would disassemble like this: 

0303- 58 CLI 

0304- 60 RTS 

Line 40 sets the interrupt vector at $3FE,3FF to point 
to location $300, which is the start of our interrupt 
routine . 

To enable interrupts, i.e. tell the 6502 to honor 
interrupt requests, line 50 makes a CALL to the simple 
instructions at $303 to clear the interrupt mask. 

To start the interrupts, line 60 accesses location $C0C0 
to turn on the Interrupt Source Card. 

So, why does the second Control-G sound funny? It's 
because interrupts are now enabled and being processed 
250 times per second by our routine at $300. This means 
that the speaker doesn't get diked as often during. the 
Control-G beep sound, and thus has a lower pitched 
s ound . 

Congratulations! You've entered and run your first 
interrupt driven program. From here on out, all that 
happens is to figure out what kind of things can be put 
in the interrupt routine to do fun things! 

This demo program is an easy way to test your system to 
make sure interrupts can be used and are working 
properly. If the program does not behave as described 
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above, read on through the next section and make sure 
the interrupt vector ($3FE,3FF) and the program at $300 
have been set up properly. Also double— check your 
Applesoft program listing for typing errors. Other 
possible problems include putting the Interrupt Source 
Card in a slot other than slot #4, or broken wires or 
components on the card itself. 

A tested copy of the above Applesoft program is included 
on vour„JLnterru pt ExD -eLXi.me-n.ter Is Kit diskette under the 
name APPLESOFT I N T_ JT E S T PROGR AM Also, if you have the 
Doubletime Printer F8 ROM installed in your computer, 
you must either delete the LDA $45 instruction from the 
interrupt routine, or use the Universal Interrupt Return 
listed in Appendix B of this manual. 



OTHER INTERRUPT CONSIDERATIONS 

After you've RUN the test program above, hit RESET to 
turn off the interrupt card. Then enter the Monitor 
with a CALL -151. Now type in: 

3FE 3FF 

and press RETURN. The screen should print out: 

03FE- 00 03 

This confirms that the interrupt vector has been set up 
properly. Now type in: 

300L 

The top of the screen should now look like this: 

0300- A5 45 LDA $45 

0302- 40 RTI 

0303- 58 CLI 

0304- 60 RTS 

As mentioned earlier, the two instructions at 300 and 
302 are the actual interrupt routine; 303 and 304 are 
the instructions to enable interrupts before turning on 
the card . 

PROBLEMS WITH INTERRUPTS 

Sad to say, there are problems with interrupts on the 
Apple, and there aren't any really easy answers to them. 



12 



The first is that interrupts are disabled whenever DOS 
accesses a diskette. The main drawback to this is that 
an interrupt driven software clock will lose time 
whenever the disk is used. This is not a problem if you 
are timing something within a program where the disk is 
not accessed, but does prevent you from timestamping 
your DOS file accurately with a software clock. 

NOTE: Hardware clocks do not suffer from this problem 
because they have an on-board chip which is the clock, 
as opposed to a software counter driven by the 6502 and 
interrupts. Many clock cards do have a provision for 
enabling interrupts though so that you can monitor the 
clock within other background programs. 

The second problem is more serious, and really compli- 
cates a number of operations. That problem is the use 
of location $45 by the Monitor interrupt handling 
routine. Remember how the interrupt handler stored the 
contents of the Accumulator in location $45? 

Imagine for a moment that the foreground program is 
using location $45 at the instant the interrupt occurs. 
Unknown to the foreground program, the contents of 
location $45 are destroyed by the interrupt handler. 

Are there routines in the computer that use location 
$45? Yes. Some important ones are the IOSAVE and 
IOREST routines at $FF4A and $FF3F in the Monitor. 
IOSAVE stores the A, X, Y, P and S registers in loca- 
tions $45 through $49. IOREST restores all these 
registers using the contents of $45 through $49. 

Where you get into trouble is when a foreground program 
uses IOSAVE at the beginning to save all the registers, 
does some operation, and then uses IOREST to restore 
all of the registers. If an interrupt occurs during the 
foreground routine after IOSAVE has been called, 
location $45 is destroyed by the interrupt. When IOREST 
is called at the end of the foreground program, the 
Accumulator will not hold the original value. This 
leads to unpredictable, and usually fatal (for the 
program), results. 

What about programs that don't use IOSAVE and IOREST? 
Unfortunately, there are a few other things that use 
location $45, most notably DOS! That's right. 

Whenever many DOS commands are processed, location $45 
is used. In fact, whenever a BSAVE or BLOAD is done 
that uses the address or length parameters (such as in 
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BSAVE FILE, A$2000, L$2000), the routine that does the 
math also uses location $45. 

Although DOS disables interrupts when it actually 
accesses the disk, during the time the calculations are 
done, it is unprotected. If an interrupt occurs during 
this period, the calculated result can be incorrect, 
again leading to unpredictable results, such as 
mis-saved file lengths, etc. 

FOR THIS REASON, YOU SHOULD NEVER LOAD OR SAVE FILES 
UNDER DOS 3.3 WITH INTERRUPTS ENABLED AND ACTIVE IN THE 
COMPUTER! 

How do clock cards and modems that use interrupts avoid 
this problem? They don't really. They caution their 
users not to allow interrupts to be enabled while 
accessing disks. The risk of interupt damage to 
location $45 is a direct function of the rate of the 
interrupts. 

This is easy to understand. If interrupts are being 
generated only once every minute, then in terms of a 
percentage, very little of the actual foreground program 
is interrupted. Many clock cards only generate an 
interrupt once every second, and this is still only 1 
out of 1,000,000 cyles for the computer. However, as 
the interrupt rate increases (and some clock cards 
support rates of up to 10,000 interrupts per second), 
the odds of an interrupt occurring in many different 
parts of a given routine increase. 

On the "other side of the interrupt", any interrupt 
program that uses the 1/0 hooks, i.e. either prints 
through COUT or uses KEYIN, can also get into trouble. 

This is because DOS uses location $45 rather freely, 
and DOS is activated for every character that goes in or 
out through the usual 1/0 channels. Thus, there is the 
potential for conflict for each character printed or 
input. DOS also uses location $45 during a CATALOG 
printout, during an INIT and during the opening and 
closing of files. 

If you do want to print something through COUT during 
your interrupt routine, there is the option of changing 
the vectors to COUT (CSW + $36, $37) within the interrupt 
routine before the printing is done, and then restoring 
them before returning with the final RTI. See the CLOCK 
demo on the Interrupt Experimenter's Kit and the discus- 
sion later in this manual for more information on this. 
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There are some other considerations when using 
interrupts also. For example, reading the paddles is a 
time - based operation. The value that the paddle read 
routine in the monitor returns to Applesoft (or a 
machine language program) depends on the time it takes 
for a certain capacitor in the computer to charge up. 

If you are stealing time with your interrupt routine, 
paddle values will come back that are artificially high 
to the foreground program. Of course, since your 
background program is immune to further interrupts, you 
can read the paddles accurately from within it. 

On the Apple //e computer, interrupts are disabled when- 
ever the screen (40 or 80 columns) is scrolled. This 
means that a software clock would also lose time 
whenever the screen scrolled. 

If all this sounds very discouraging, take heart! Most 
of this can be managed as long as you are careful to 
remember where the pitfalls lie. That s why it s 
important to be aware of them. 

For example, if you want to read the paddles during an 
Applesoft program that uses interrupts, just turn off 
interrupts while you're reading the paddle. We already 
mentioned that interrupt routines that want to print 
something can temporarily keep DOS out of the picture 
while they are working. 

You'll probably find that even with the limitations 
mentioned, there are a number of fun things you can do 
with interrupts in your own programs. 



A "SHELL" INTERRUPT ROUTINE 

To continue our experiments, let's look at the "shell” 
of a simple interrupt routine. In fact, this shell is 
so simple it doesn't do anthing except set up a bunch 
of NOP's as the routine! 

On the following two pages is the listing for this 
interrupt routine. Let's examine each line of the 
source listing to see exactly how it works. 

The first thing to notice is that this routine sets up 
its own interrupt vector. When you think about it, this 
is a good approach. The routine itself is only directly 
called once, and this is when the setup is done. After 
that, successive calls are done indirectly as each 
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interrupt initiates a jump to the functional part of the 
routine via the interrupt vector. 

Specifically, lines 12 through 15 in the source listing 
load the low and high order bytes of the address of 
START, and put these in $3FE,$3FF to set up the inter- 
rupt vector. Line 16 then clears the interrupt flag to 
enable the 6502 to recognize interrupts, and line 17 
turns on the Interrupt Source Card. The RTS on line 18 
(DONE) then returns to the calling program (or user). 

Lines 20 through 22 are a data storage area that will be 
used to store the contents of the A, X and Y registers 
in just a moment. 

When the first interrupt occurs, the 6502 will jump to 
START via the interrupt vector. Lines 24 through 26 
store the contents of the A, X and Y registers. Remem- 
ber, this is done because when our interrupt routine is 
finished, we have to return to the foreground program 
with everything in the same condition as when we entered 
the interrupt routine. Although the Accumulator has 
presumably already been saved in location $45 by the 
Monitor's interrupt handler (and in fact is no longer 
the "true" value), this form of the source listing will 
be easier to alter when alternate Monitor ROM's are 
discussed in Appendix B. 

Lines 28 through 30 are just some symbolic NOP's that 
represent where you would put your own program if you 
were writing an interrupt routine. 

When the routine is finished and ready to return to the 
foreground program, lines 32 through 34 restore the A, 
X and Y registers before the final RTI. Again, since 
location $45 holds the true Accumulator value, SAVREG is 
not used to restore the Accumulator. 
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1 ******************************** 

2 * "SHELL" INTERRUPT ROUTINE * 

o ******************************** 















OBJ 


$300 












6 




ORG 


$300 












7 

8 


IRQ 


EQU 


$3FE ; 


; INTERRUPT VECTOR 










9 


INTCRD 


EQU 


$COCO ; 


; SOFTSWITCH TO TURN 


















ON CARD 










10 






3 


; $ CO ( 8+N ) 0 










11 










0300 : 


A9 


12 




12 


INIT 


LDA 


#< START 




0302 : 


8D 


FE 


03 


13 




STA 


IRQ 




0305 : 


A9 


03 




14 




LDA 


#> START 




0307 : 


8D 


FF 


03 


15 




STA 


IRQ+1 


SET UP IRQ VECTOR 


0 30A : 


58 






16 




CLI 




ENABLE INTERRUPTS 


030B : 


AD 


CO 


CO 


17 




LDA 


INTCRD 


TURN ON CARD 


030E : 


60 






18 


DONE 


RTS 














19 










030F : 


00 






20 


SAVREGS 


HEX 


00 


ACC 


0310 : 


00 






21 




HEX 


00 


X-REG 


0311 : 


00 






22 




HEX 


00 


Y-REG 










23 










0312: 


8D 


OF 


03 


24 


START 


STA 


SAVREGS 




0315 : 


8E 


10 


03 


25 




STX 


SAVREGS+1 




0318 : 


8 C 


11 


03 


26 




STY 


SAVREGS+2 












27 










03 IB : 


EA 






28 




NOP 






03 1C : 


EA 






29 




NOP 




; YOUR PROGRAM HERE 


03 ID : 


EA 






30 




NOP 














31 










03 IE : 


A5 


45 




32 


RETURN 


LDA 


$45 


RESTORE ACC. 


0320 : 


AE 


10 


03 


33 




LDX 


SAVREGS+1 


RESTORE X 


0323 : 


AC 


11 


03 


34 




LDY 


SAVREGS+2 


RESTORE Y 










35 










0326 : 


40 






36 


FINISH 


RTI 
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THE CLOCK SIMULATOR 



This next interrupt routine actually does something. It 
simulates a clock function by using the interrupts as a 
timer. Each time an interrupt occurs, the routine 
increments certain counters and displays an elapsed time 
in the upper left hand corner of the screen. 

Before describing the actual lines in the routine, 
let's take an overview of how the routine is expected 
to perform. 

Once the routine is loaded, the interrupt vectors set 
up and interrupts started, the routine will be called 
approximately 250 times per second. 

If the interrupts occurred just once each second, then 
we could just increment a second-counter register to 
keep track of the elapsed time. In this case though 
we'll need another counter to count each interrupt, so 
as to be able to increment the time counter once every 
250 calls to the routine. 

On each 250th call then, we'll click the speaker to 
make a ’’tick" noise (alternate ’’tock" is left as an 
exercise to the reader!..) and print the time (in hex) 
on the screen. 

To see how this general plan is implemented, look at 
the listing on the following pages. 

The initialization (INIT) on lines 21 through 34 are 
patterned after the SHELL INTERRUPT ROUTINE discussed 
earlier, but you'll notice the time data register TIME 
is initialized to zero for the clock counter and the 
cycle counter (INTCNT for Interrupt Counter) is set to 
'250' . 

When an interrupt occurs, lines 47 through 57 save A, X 
and Y, but also save the horizontal screen cursor 
position (CH), BASL,H and a temporary register called 
YSAV1 . 

These last special bytes are all used by the print 
routine that will be called within the interrupt 
routine. Because we must restore the complete system 
before returning from the interrupt routine, any bytes 
altered must be saved so they can be restored later. 

TEST (lines 59-62) decrements the interrupt counter, and 
at the same time checks to see if it has reached zero 
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yet. If not, the routine jumps to the exit section, 
FINSEC, which will be discussed in just a moment. 

When INTCNT reaches zero, the program falls through 
’’TEST” to NEWSEC on line 64. This resets the interrupt 
counter back to 250 and increments the TIME counter. 

CLICK then executes a short loop that clicks the speaker 
four times. Between each click is a short wait so that 
the click loop is slow enough to be heard. (Without a 
wait the loop would be too fast for the speaker to even 
respond to! ) . 

PRINT (lines 81 through 98) first does the equivalent 
of an HTAB 1: VTAB 1. We could just do the printing 
now, but because DOS is constantly processing all 
output, printing with DOS active during an interrupt 
routine can change data elsewhere in the computer (most 
importantly, zero page addresses) that are impossible 
to keep track of from the interrupt routine. 

An easy way of avoiding this is to take DOS out of the 
output path by pointing COUT directly at the screen 
output routine at $ FDFO . This keeps DOS out of trouble 
for a while. Lines 92-94 use the PRNTAX routine in the 
Monitor to print the time in hexidecimal. Lines 95-98 
then restore the COUT vector (CSW = $36,37) to its 
original value. 

This brings us to FINSEC, which is pretty much the 
usual exit routine. Lines 100-111 restore all the 
registers and zero page bytes that may have been changed 
by the interrupt routine. 

Note that the label FREQ is set equal to an assumed 
number of interrupts per second. Because the actual 
frequency of individual Interrupt Source Cards vary 
widely, you may want to change to value of FREQ to give 
a more accurate time for your own card. 
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1 ******************************** 

2 * CLOCK SIMULATOR * 

■i ******************************** 











5 




OBJ 


$300 












6 

7 




ORG 


$300 












/ 

8 


IRQ 


EQU 


$ 3 FE ; 


INTERRUPT VECTOR 










9 


SPKR 


EQU 


$C030 












10 


INTCRD 


EQU 


$C0C0 ; 


. SOFTSWITCH TO TURN 


















ON CARD 










1 1 


CH 


EQU 


$24 ; 


, HORIZ CURSOR 


















POSITION 










12 


BASL 


EQU 


$28 












13 


VTAB 


EQU 


$ F C 2 2 












14 


PRNTAX 


EQU 


$ F9 4 1 












15 


YSAV1 


EQU 


$35 ; 


; USED BY COUT 


















(PRNTAX) 










16 


WAIT 


EQU 


$FCA8 












17 


CHROUT 


EQU 


$ F D F 0 


VIDEO OUT 










18 


CSW 


EQU 


$36 


OUTPUT VECTOR 










19 


FREQ 


EQU 


250 


INT SOURCE CARD 


















FREQ . 










20 










0300 ; 


; A9 


2 C 




21 


IN IT 


LDA 


/K START 




0302 : 


: 8D 


FE 


03 


22 




STA 


IRQ 




0305 ; 


: A9 


03 




23 




LDA 


#> START 




0307 : 


: 8D 


FF 


03 


24 




STA 


IRQ+1 ; 


; SET UP IRQ VECTOR 


030A : 


: A9 


00 




25 




LDA 


#$00 




03 OC : 


: 8D 


21 


03 


26 




STA 


TIME j 


; SET TIME = 0 


030F : 


: 8D 


22 


03 


27 




STA 


TIME+1 




0312 : 


: A9 


2 C 




28 




LDA 


#<FR£Q j 


; # OF INTERRUPTS 


















PER SECOND 


0314 


8D 


23 


03 


29 




STA 


INTCNT ; 


; SET FOR COUNT-DOWN 


0317 


A9 


01 




30 




LDA 


# >FREQ 




0319 


8D 


24 


03 


31 




STA 


INTCNT+1 




0 3 1 C 


58 






32 




CLI 




; ENABLE INTERRUPTS 


03 ID 


AD 


CO 


CO 


33 




LDA 


INTCRD ; 


; TURN ON CARD 


0320 


60 






34 


DONE 


RTS 














35 










0321 : 


: 00 


00 




36 


TIME 


HEX 


0000 : 


; TIME COUNTER 


0323 : 


: 00 


00 




37 


INTCNT 


HEX 


0000 


; CURRENT INTERRUPT 


















OF SERIES 










38 










0325 : 


: 00 






39 


SAVEREG 


HEX 


00 


ACC STORAGE LOC. 


0326 ; 


: 00 






40 




HEX 


00 


X-REG 


0327 : 


: 00 






41 




HEX 


00 


Y-REG 


0328 : 


: 00 






42 




HEX 


00 


CH 


0329 : 


: 00 






43 




HEX 


00 


BASL 


0 32 A : 


: 00 






44 




HEX 


00 


BASL+1 


032E : 


: 00 






45 




HEX 


00 


YSAV1 



20 









46 












032C: 8D 


25 


03 


47 


START 


STA 


SAVEREG 


* 


SAVE ACC 


032F: 8E 


26 


03 


48 




STX 


SAVEREG+1 


9 


SAVE X 


0332: 8C 


27 


03 


49 




STY 


SAVEREG+2 


9 


SAVE Y 


0335: A5 


24 




50 




LDA 


CH 






0337: 8D 


28 


03 


51 




STA 


SAVEREG+3 


l 


SAVE CH 


0 3 3 A : A5 


28 




52 




LDA 


BASL 






033 C : 8D 


29 


03 


53 




STA 


SAVEREG+4 






033F: A5 


29 




54 




LDA 


BASL+1 






0341: 8D 


2 A 


03 


55 




STA 


SAVEREG+5 


9 


SAVE BASL, BASH 


0344: A5 


35 




56 




LDA 


YS AVI 






0346: 8D 


2B 


03 


57 




STA 


SAVEREG+6 


9 


SAVE YS AV 1 








58 












0349: CE 


23 


03 


59 


TEST 


DEC 


INTCNT 


9 


ARE WE IN THE 
MIDDLE OF A 
SEGMENT? 


0 3 4 C : DO 


4B 




60 




BNE 


FINSEC 


> 


BRANCH IF YES (NO 
ACTION) 


0 34E : CE 


24 


03 


61 




DEC 


INTCNT+1 






0351: 10 


46 




62 




BPL 


FINSEC 












63 












0353: A9 


2 C 




64 


NEWSEC 


LDA 


# < F RE Q 


9 


REFRESH COUNTER 


0355: 8D 


23 


03 


65 




STA 


INTCNT 






0358: A9 


01 




6 6 




LDA 


#>FREQ 






0 3 5 A : 8D 


24 


03 


67 




STA 


INTCNT+1 






035D: EE 


21 


0 3 


68 




INC 


TIME 


J 


TIME = TIME + 1 


0360: DO 


03 




69 




BNE 


CLICK 






0362: EE 


22 


03 


70 




INC 


TIME+1 












71 












0365: AO 


04 




72 


CLICK 


LDY 


#$04 


i 


# OF TIMES TO 
CLICK SPEAKER 


0367: 2C 


30 


CO 


73 


Cl 


BIT 


SPKR 


9 


CLICK THE SPEAKER 


0 3 6 A : 88 






74 




DEY 








0 3 6 B : FO 


08 




75 




BEQ 


PRINT 






036D: A9 


OA 




76 




LDA 


// $0 A 


t 


TIME TO WAIT 


0 3 6 F : 20 


A8 


FC 


77 




JSR 


WAIT 


I 


WAIT TO CLICK 
AGAIN 


0372: 18 






78 




CLC 








0373: 90 


F 2 




79 




BCC 


Cl 


} 


ALWAYS 








80 












0375: A9 


00 




81 


PRINT 


LDA 


#00 






0377: 85 


24 




82 




STA 


CH 


9 


HTAB 1 


0379: 20 


24 


FC 


83 




JSR 


VTAB+2 


9 


VTAB 1 


03 7C: A5 


36 




84 




LDA 


CSW 






037E : 48 






85 




PHA 








03 7 F : A5 


37 




86 




LDA 


CSW+1 






0381: 48 






87 




PHA 




t 


SAVE CURRENT CSW 
VECTOR 


0382: A9 


FO 




88 




LDA 


#<CHR0UT 






0384: 85 


36 




89 




STA 


CSW 






0386: A9 


FD 




90 




LDA 


# >CHR0UT 







21 



0388: 


85 


37 




91 




STA 


038A: 


AE 


21 


03 


92 




LDX 


038D : 


AD 


22 


03 


93 




LDA 


0390 : 


20 


41 


F9 


94 




JSR 


0393: 


68 






95 




PLA 


0394 : 


85 


37 




96 




STA 


0396 : 


68 






97 




PLA 


0397 : 


85 


36 




98 




STA 










99 






0399 : 


AD 


28 


03 


100 


FINSEC 


LDA 


039C : 


85 


24 




101 




STA 


0 3 9 E : 


AD 


29 


03 


102 




LDA 


0 3 Al : 


85 


28 




103 




STA 


0 3 A3 : 


AD 


2A 


03 


104 




LDA 


03A6 : 


85 


29 




105 




STA 


0 3 A8 : 


AD 


2B 


03 


106 




LDA 


03AB : 


85 


35 




107 




STA 


03AD: 


AE 


26 


03 


108 




LDX 


03B0 : 


AC 


27 


03 


109 




LDY 










110 






03B3 : 


A5 


45 




111 


RETURN 


LDA 


03B5 : 


40 






112 


FINISH 


RTI 



CSW+1 

TIME 

TIME+1 


9 


CSW = $FDF0 


PRNTAX 


) 


PRINT TIME IN HEX 
SECONDS 


CSW+1 


CSW 


9 


RESTORE 


COUT HOOKS 


SAVE REG+3 


CH 

SAVEREG+4 

BASL 

SAVEREG+5 


j 


RESTORE 


CH 


BASL+1 

SAVEREG+6 


9 


RESTORE 


BASL 


YSAV1 


9 


RESTORE 


YSAV1 


SAVEREG+1 


9 


RESTORE 


X 


SAVEREG+2 


9 


RESTORE 


Y 


$45 


9 


RESTORE 


ACC 
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USING INTERRUPT ROUTINES FROM APPLESOFT 



It is possible to use interrupt routines from Applesoft 
BASIC, as demonstrated by the first experiment in this 
manual. To save having to use POKE'S to set up things 
though, some extra routines have been included in the 
package to make using interrupts a little bit easier. 
These routines are IRQ ON.TB and IRQ OFF.TB. 

USING THE ROUTINES WITH THE WORKBENCH 

I n c 1 In terru pt Experimenter's Kit is a 

f ree^Trial Size Toolkit diskette. This is sample of 

a s er x e s ■■■ of '-wt h-e? - Wa g n e r Publishing products 

called "The Toolbox Series”. 

The Toolbox system is a special utility called The 
Workbench plus a large set of new commands that can be 
added to any Applesoft program. These commands are 
added (usually in less than a minute) using the 
Workbench utility. 

The easiest way to use the routines IRQ ON.TB and IRQ 
OFF.TB is to use the Workbench utility that is included 
in the Trial Size Toolbox package. If you do not want 
to do this, skip to the next section on using the 
routines without the Workbench utility. 

If you are using the Workbench, the Toolbox files IRQ 
ON.TB and IRQ OFF.TB can be added just like any other 
Toolbox command. The functions of these commands are as 
follows : 



IRQ ON.TB 

This command will set up the interrupt vector at 
$3FE , 3FF to the address of your choice, enable inter- 
rupts with the required CLI instruction, and turn on the 
Interrupt Source Card (assumed to be in slot #4). 



IRQ OFF.TB 

This command disables interrupts by setting the 
interrupt mask flag with an SEI instruction and turns 
off the Interrupt Source Card (still assumed to be in 
slot # 4 ) . 

Here is a sample Applesoft program that uses the SHELL 
INTERRUPT ROUTINE as an example: 
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1 CALL PEEK( 175) + 256 * PEEK(176) - 46 
5 D$ = CHR$ ( 4 ) : REM CONTROL-D DOS COMMANDS 

20 PRINT D$ ; ’’BLOAD SHELL INTERRUPT ROUTINE, A768": 

REM A$300 

100 PRINT CHR$ ( 7 ) : REM PRINT NORMAL BELL SOUND 

110 &” IRQON ”, 7 68 : REM TURN ON INTERRUPTS 

120 PRINT CHR$ ( 7 ) : REM PRINT INT BELL SOUND 
130 & " I RQOF F “ : REM TURN OFF INTERRUPTS 

140 PRINT CHR$ ( 7 ) : REM PRINT NORMAL BELL AGAIN 

150 END 

The idea behind this program is to load the SHELL 
INTERRUPT routine into memory at address 768 ($300 hex). 

The syntax for turning on interrupts is to use the IRQ 
ON.TB command, followed by a comma and the address that 
you want the interrupt vector to point to. This would 
usually be the first byte of your interrupt routine. In 
this case that is location 768. 

When this program is run, the BELL sound (Control— G) 
should first be normal, then sound like a buzz, and 
then return to normal. 

The syntax for turning off the interrupts is to just 
use the command IRQ OFF.TB. No address variables are 
required . 

IRQ ON.TB and IRQ OFF.TB can be used as many times as 
you like within your Applesoft program to turn inter- 
rupts off and on. Also note that you can use a hexi- 
decimal address in IRQ ON.TB by just putting a dollar 
sign in front of the hex number you wish to use as the 
address. For example, line 110 of the sample program 
above could also look like this: 

110 & ” IRQON" , $ 3 00 : REM TURN ON INTERRUPTS 



SUMMARY OF IRQ ON.TB AND IRQ OFF.TB 

IRQ ON.TB: Length: 76 bytes ($4 b) 

Syntax: & "NAME '* [,aexpr|,hexnum] 

& "NAME " [, ADDRESS] 



Sample: &"IRQ0N" 

& " I RQO N " , AD 
& " IRQON" ,$300 
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Function: IRQ ON.TB enables interrupts with the CLI 
instruction and turns on the Interrupt Source Card in 
slot # 4. If an address is specified, the interrupt 
vector at $3FE,3FF will be set to that address. 

Limitations: IRQ ON.TB assumes the Interrupt Source 
Card is in slot #4. If you have the card in another 
slot, either re-assemble the source file with line # 77 
changed accordingly, or alter byte 72 of the object file 
to 128 + 16 * slot # (Example: for slot #3, byte 72 * 
128 + 16 * 3 = 176). Also, if a hex value is used for 
the address, it must be specified as shown in the 
example, and not as a string variable (i.e. don't use 
quotes or a string variable). 



IRQ OFF.TB: Length: 5 bytes ($5) 

Syntax: &”NAME" 

Sample: &" IRQ OFF" 

Function: IRQ OFF.TB disables interrupts with the SEI 

instruction and turns off the Interrupt Source Card in 
slot # 4 . 

Limitations: IRQ OFF.TB assumes the Interrupt Source 
Card is in slot #4. If you have the card in another 
slot, either re-assemble the source file with line #20 
changed accordingly, or alter byte 2 of the object file 
to 192 + slot # (Example: for slot #3, byte 2 = 192 + 3 

= 195). 

USING THE ROUTINES WITHOUT THE WORKBENCH 

If you do not want to use the Workbench to add the 
commands IRQ ON.TB and IRQ OFF.TB to your Applesoft 
program, then just follow the steps here. 

IRQ ON.TB 

This routine will set up the interrupt vector at 
$3FE,3FF to the address of your choice, enable inter- 
rupts with the required CLI instruction, and turn on the 
Interrupt Source Card (assumed to be in slot #4). 

IRQ OFF.TB 

This routine disables interrupts by setting the 
interrupt mask flag with an SEI instruction and turns 
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off the Interrupt Source Card (still assumed to be in 
slot # 4 ) . 

Here's an Applesoft BASIC program that uses these two 
routines along with the SHELL INTERRUPT ROUTINE as an 
example * 

5 D$ = CHR$ ( 4 ) ; REM CONTROL-D DOS COMMANDS 

10 PRINT D $ ; "BLOAD IRQ ON.TB, A768": REM A$300 
20 PRINT D$; "BLOAD IRQ OFF.TB, A848": REM A$350 
30 PRINT D$ ; " BLOAD SHELL INTERRUPT ROUTINE, A864": 

REM A$ 3 60 

100 PRINT CHR$ ( 7 ) : REM PRINT NORMAL BELL SOUND 

110 CALL 768,864: REM TURN ON INTERRUPTS 

120 PRINT CHR$ ( 7 ) : REM PRINT INT BELL SOUND 

130 CALL 848: REM TURN OFF INTERRUPTS 
140 PRINT CHR$(7): REM PRINT NORMAL BELL AGAIN 

150 END 



The idea behind this program is to first load the IRQ 
ON.TB and IRQ OFF.TB routines into memory, along with 
the SHELL INTERRUPT ROUTINE. 

The syntax for turning on interrupts is to call the IRQ 
ON.TB routine, followed by a comma and the address that 
you want the interrupt vector to point to. This would 
usually be the first byte of your interrupt routine. In 
this case that would be location 864 ($360 hex) . 

When this program is run, the BELL sound (Control-G) 
should first be normal, then sound like a buzz, and 
then return to normal. 

The syntax for turning off the interrupts is to just 
call the address of IRQ OFF.TB. No address variables 
are required . 

IRQ ON.TB and IRQ OFF.TB can be called as many times as 
you like within your Applesoft program to turn inter- 
rupts off and on- Also note that you can use a hexi- 
decimal address in IRQ ON.TB by just putting a dollar 
sign in front of the hex number you wish to use as the 
address. For example, line 110 of the sample program 
above could also look like this: 

110 CALL 768 , $360: REM TURN ON INTERRUPTS 
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1 ************************** 

2 * * 

3 * IRQ VECTOR SETUP * 

4 * BY OSMERIOD & PENTALIC * 

5 * 8/1/84 * 

6 * * 

7 ************************** 

8 * 

9 * 

10 ***************************** 

11 * NOTE: SYNTAX FROM BASIC IS: 

12 * & " N AME " , $ F F F F OR 65536 

^3 ***************************** 

14 * 











15 




OBJ 


$300 










16 


* 














17 


A2L 


EQU 


$ 3E 










18 


A2H 


EQU 


$3F 










19 


CHRGET 


EQU 


$ B 1 










20 


CHRGOT 


EQU 


$ B 7 










21 


GETNUM 


EQU 


$FFA7 










22 


LINNUM 


EQU 


$50 










23 


FRMNUM 


EQU 


$DD6 7 










24 


GETADR 


EQU 


$ E 7 5 2 










25 


IRQ 


EQU 


$ 3FE 










26 


* 














27 
















28 


* CHECK NEXT 


CHARACTER 










29 


* AND 


BRANCH 


IF NO PARAMETERS 










30 


* ARE 


GIVEN TO IRQON 










31 


* ELSE 


CHECK 


IF PARAMETER IS 










32 


* HEX 


OR DEC 


& BRANCH ACCORDINGLY 










33 








8000 : 


20 


B 7 


00 


34 


ENTRY 


JSR 


CHRGOT 


8003 : 


FO 


42 




35 




BEQ 


IRQON 


8005 : 


C9 


24 




36 




CMP 


#'$ ; HEX VALUE 


8007 : 


DO 


2E 




37 




ENE 


FPNUM ; NO 










38 


* 






8009 : 


AO 


00 




39 




LDY 


#$00 


800B : 


20 


B 1 


00 


40 


XFER 


JSR 


CHRGET 


800E: 


C9 


30 




41 




CMP 


#'0 


8010 : 


90 


14 




42 




BCC 


PROCESS 


8012 : 


C9 


3 A 




43 




CMP 


#': 


8014 : 


90 


08 




44 




BCC 


XI 


8016 : 


C9 


41 




45 




CMP 


#' A 


8018 : 


90 


OC 




4 6 




BCC 


PROCESS 


80 1 A : 


C9 


47 




47 




CMP 


#'G 


80 1C : 


BO 


08 




48 




BCS 


PROCESS 










49 


* 






80 IE : 


09 


80 




50 


XI 


ORA 


#$80 


8020: 


99 


00 


02 


51 




STA 


$200 ,Y 
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8023 : 

8024 : 

8026 : 
8028 : 
802B : 
80 2D : 
80 2 F : 
8031 : 
8033 : 
803 5 : 

8037 : 
80 3 A : 

80 3D : 
803F : 
8042 : 
8044 : 



8047: 
804A : 
804B : 



8000 

8003 

8004 



C8 






52 




INY 




DO 


E5 




53 




BNE 


XFER 








54 


* 






AO 


00 




55 


PROCESS 


LDY 


#$00 


20 


A7 


FF 


56 




JSR 


GETNUM 


A5 


3E 




57 




LDA 


A2L 


85 


50 




58 




STA 


LINNUM 


A5 


3F 




59 




LDA 


A2H 


85 


51 




60 




STA 


LINNUM+1 


AO 


00 




61 




LDY 


#$00 


FO 


06 




62 




BEQ 


HOOK 








63 


* 






20 


67 


DD 


64 


FPNUM 


JSR 


FRMNUM 


20 


52 


E 7 


65 




JSR 


GETADR 








66 


* 






A5 


50 




67 


HOOK 


LDA 


LINNUM 


8D 


FE 


03 


68 




STA 


IRQ 


A5 


51 




69 




LDA 


LINNUM+1 


8D 


FF 


03 


70 




STA 


IRQ+1 








71 


* 












72 


* FIND 


END OF 


STATEMENT OR LINE 



73 * AND SET TXTPTR. ACTIVATE THE 

74 * CARD AND ENABLE INTERRUPTS 

75 * (CARD ASSUMED TO BE IN SLOT 4) 

76 



AD 


CO 


CO 


77 


IRQ ON LDA $C0C0 


; $ CO ( 8+N ) 0 


58 






78 


CLI 




60 






79 


RTS 










1 


************************* 


* 








2 


* 


* 








3 


* IRQ TURN OFF 


* 








4 


* BY OSMERIOD & PENTALIC 


* 








5 


* 8/L/84 


* 








6 


* 


* 








7 


************************* 


* 








8 


* 










9 


************************* 


** ** 








10 


* NOTE: SYNTAX FROM BASIC 


IS : 








11 


* & "NAME " 










12 


************************* 


** * * 








13 


OBJ $300 










14 












15 


IRQ EQU $3FE 










16 












17 


* DEACTIVATE CARD (ASSUME 


S SLOT 








18 


* FOUR) AND TURN OFF IRQ' 


S 








19 






AD 


00 


C4 


20 


IRQOFF LDA $C400 


; TURN OFF CARD 


78 






21 


SEI 


; DISABLE INTS 


60 






22 


DONE RTS 
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USING INTERRUPTS WITHOUT THE INTERRUPT SOURCE CARD 



The Interrupt Source Card is provided in the Interrupt 
Experimenter's Kit so that you can have an easy and 
immediate way of generating interrupts in your own 
Apple . 

Does this mean that the programs you write that use 
interrupts will only work on your Apple? Not neces- 
sarily. There are many peripheral devices for the Apple 
that can generate their own interrupts. The most common 
examples are clock cards, serial interface cards and 
modems. There are also combination devices like the 
Prometheus VERSACARD that can generate interrupts too. 

To see how these can generate interrupts, refer to the 
manuals for the device you have (or have access to), and 
see what is required to turn the interrupts on. The 
only difference in using interrupts from a peripheral 
card other than the Interrupt Source Card is that a 
location other than $C080 may have to be accessed to 
turn the card on. Otherwise all the programs on the 
Interrupt Experimenter's Kit diskette will work fine. 

With a little thought, you should be able to think of 
all sorts of possible applications for interrupts. What 
might these things be? Here's a short list. 

1. Display the time (you need a real hardware clock for 
this) • 

2. Run the Printer in background mode (See the note 
about Doubletime Printer later in this manual) . 

3. Upload a text file through a modem to a distant 
computer . 

4. Download data from a distant computer to a RAM or 
disk buffer (each character arrives through the 
modem) . 

5. Reading scientific or industrial measurement 
equipment (from Apple's game port or other sources). 

6. Hi-Res game background features. 

7. Using the computer to monitor time and control BSR 
household controllers while still being able to run 
foreground programs. 

Remember, in adding one or more of these functions you 
would not be dedicating your computer, you would be 
sharing the resource among various tasks. 
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OTHER HARDWARE CONSIDERATIONS 



SHARED ROM 

The Apple's $C800-CFFF memory is "shared". Each peri- 
pheral slot selects to use it if it needs it and ignores 
it if it doesn't. If a peripheral card has ROM on it, 
the card is required to select the C800 space which 
removes entirely, without a trace, the previous selec- 
tion. For one device to use the address space it must 
turn off all devices. 

If the interrupt routine uses a device that uses $C800 
space (such as downloading text material from a 
hard-disk or sending a character to an 80— column 
display) the interrupt routine must take care to restore 
the $ C800 user who may have been in charge when the 
interrupt occured. Apple Computer has defined a 
protocol for use of $C800 space. Unfortunately, not 
everyone (including Apple) has always implemented this 
protocol . 

The protocol requires any user of the $C800 space to 
inform the general system by leaving the slot number in 
location $7F8 in the form of "Cs”, where s=slot number. 
Reading CsOO should turn on the ROM for the board in 
slot s. Reading CFFF should turn off all ROMS. Some, 
or all, of this protocol has been ignored by some or all 
versions of the APPLE COM CARD, VIDEX VIDEOTERM, AXLON 
RAMDISK, SORRENTO VALLEY ASSOCIATES APPLECACHE. There 
are probably other boards that do not follow the 
convention. 



PAGED RAM CARDS 

Remember we said that interrupt programs shouldn't even 
leave footprints? Interrupt programs must not tiptoe 
through the RAM CARDS. Most RAM cards on the market do 
not permit users to read the status of the read/write or 
bank select circuitry. This means that if the interrupt 
program changes the RAM card status it will not be able 
to restore it to what the foreground task expects. This 
nearly guarantees a program crash. The only exceptions 
to this oversight that we know of are the Microsoft 16K 
card and the Prometheus Expand-A-Ram 128k card. 

Another, more dangerous, potential problem can occur 
with RAM cards. Suppose the foreground task is using a 
RAM card for data storage. What would happen if there 
were an interrupt when the RAM card was enabled for 
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read? Well, the 6502 would look to locations FFFE and 
FFFF for the vector to the IRQ routine. There's an old 
principle in computers, "Data executes like garbage! 
Such a situation would probably send the APPLE off into 
the weeds. 



DEMONSTRATION PROGRAMS AND OTHER GOODIES. ♦♦ 

The remainder of this manual consists of Appendices 
that provide additional information about interrupts 
and your Apple. 

Appendix A lists the known conflicts between the 
Monitor and DOS (i.e. location $45) and the use of 
interrupts and will help you anticipate possible 
problems using interrupts on your Apple. 

Appendix B is a description of how the Monitor ROM can 
be altered to avoid these conflicts, and includes a 
special offer for a print spooling software package 
(Doubletime Printer) that includes a modified F8 Monitor 
ROM that not only fixes the interrupt problem (location 
$45 conflict) for Apple II computers (sorry, not for the 
//e or lie), but also fixes the problem with the auto- 
matic converting of lower case letters when you copy 
over them with the cursor! 

There is also a description of a "Universal Interrupt 
Return” procedure that will let your interrupt routines 
work with either the standard or modified F8 Monitor ROM 
described in this section. 

Appendix C contains explanations of some additional 
demonstration programs included on the Interrupt 
Experimenter's Kit diskette. 



Well, if you heed the cautions mentioned throughout 
this manual, and use some care in writing your 
interrupt routines, you should be pretty safe in using 
interrupts. Interrupts can be a very interesting area 
of computer programming. We hope this package has been 
of help in teaching you about this fascinating part of 
your Apple computer. Gotta go now... It looks like 
someone is a about to push the RESET butto 
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APPENDIX A: LOCATION $45 CONFLICTS 



As mentioned earlier in the manual, there are a number 
of routines built into the Apple Monitor and DOS that 
use location $45. The problem created here is that if 
an interrupt occurs while any of these routines are 
being used, the calculations they perform or data that 
they handle will be destroyed. 

Following is a list of the known locations in the 
Monitor and DOS that reference location $45, along with 
comments about the usage. Applesoft does not use 
location $45. 

This list is provided to give you an idea of where 
possible conflicts may arise when using interrupts 
within your own programs. 

Although the Monitor can be modified to avoid the 
location $45 usage problem, modifying DOS is a more 
substantial project. Information on modifying the 
Monitor is provided in the next Appendix. Short of 
these techniques, the best solution is brought to mind 
by the story of the man who goes into the doctor and 
tells him "I hurts when I do this {performing a certain 
unusual motion with his body} » Replied the doctor, 
’’Well, then don't do that!" 



MONITOR REFERENCES TO LOCATION $45 
(Auto~Boot ROM) 

Actual Location of Reference: $FA40 (STA $45) 

Part of the Routine: IRQ ($FA40) 

Purpose/Comments : Jumped to by vector at $FFFE, FFFF 
on any BRK , or on IRQ if bit 3 of Status Register is 
clear (i.e. CLI to enable interrupts). 

Actual Location of Reference: $FF42 (LDA $45) 

Part of the Routine: IOREST ( $ FF3 F ) (also called 

RESTORE} 

Purpose/Comments : Used to restore Accumulator and 

other registers. See the Monitor 'G' (for Go) routine. 
IOREST is also used by other programmers writing their 
own routines, and this use is difficult, if not 
impossible to document. 
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Monitor References 



Cont' d 



Actual Location of Reference: $FF4A (STA $45) 

Part of the Routine: IOSAVE ( $FF4A) {also called SAVE} 

Purpose/Comments: Used on to save A, X, Y, P and S 

registers. Like IOREST, IOSAVE is also used by other 
programmers writing their own routines, and thus its use 
is difficult to document. 



Actual Location of Reference: $FEB9 (JSR 

Part of the Routine: GO ($FEB6) 
Purpose/Comments: Used to set A, X, Y, P 
registers and then jump to an address spe 
user (Example: 300G) . Most people don't 

about this feature of the Monitor so it's 
be a problem. 



$FF3F) 
and S 

cified by the 
even know 
not likely to 



DOS 3.3 REFERENCES TO LOCATION $45 



Actual Location of Reference: $A157 ( LDA $45) 

Part of the Routine: SETDFLTS ($A0D1) 

Purpose/Comments: Sets slot, drive, volume, etc. 

defaults on any DOS command. 

Actual Location of Reference: $A200 (ROL $45) 

Part of the Routine: GETNUM ($A1B9) 

Purpose/Comments: Converts ASCII string numbers (hex 

or decimal) into actual integer bytes for DOS. Used 
during any numeric calculation of drive, slot, volume, 
length, address, etc. 

Actual Location of Reference: $A2CB (LDA $45) 

Part of the Routine: CMDHDLR ($A2A8) 

Purpose/Comments: Part of command handler for DOS. 

File manager setup used by various DOS commands. 

Actual Location of Reference: $A77E (STA $45) 

Part of the Routine: LOCBUF ($A764) 

Purpose/Comments: Finds free file buffer for DOS file 

data transfer. 



Actual Location of Reference: $ADB9 (STX $45) 

Part of the Routine: CATHNDLR ($AD98) 

Purpose/Comments: Part of CATALOG routine that prints 
the volume number for a disk. See PRTDEC ($AE42). 



Actual Location of Reference: $AE09 (STA $45) 

Part of the Routine: FILESIZ ($AE01) 

Purpose/Comments: Prints file size of each file during 
a CATALOG (see PRTDEC - $AE42). 
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DOS 3.3 References 



Cont ' d 



Actual Location of Reference: $AE53 (LDA $45) 

Part of the Routine: PRTDEC ($AE42) 

Pur pose/ Comment s : Prints decimal number based on 

integer bytes in $44,45. Used by DOS a lot, and 
occasionally by programmers in need of a decimal 
printing routine! 

Actual Location of Reference: $BED2 (STA $45) 

Part of the Routine: DSKFRMT ($BEAF) 
Purpose/Comments: Part of INIT routine. 

Actual Location of Reference: $BF15 (LDY $45) 

Part of the Routine: TRKFRMT ($BF15) 
Purpose/Comments: Formats a given track during an 

INIT. 

Actual Location of Reference: $BF38 (LDY $45) 

Part of the Routine: INITMAP ($BF32) 

Pur pose/ Comment s : Marks a track as formatted. Still 
part of INIT. 

Actual Location of Reference: $BF54 , BF56 , BF5A 

(CMP, LDA, STA $45) 
Part of the Routine: INITMAP ($BF32) 

Purpose/ Comments : Still part of INIT. 

Actual Location of Reference: $BF9 C , BFA2 , BFA4 

(LDA, LDA, DEC $45) 
Part of the Routine: MARKMAP ($BF8B) 

Purpose/Comments: Part of track format part of INIT. 



As you can see from all this, the inescapable con- 
clusion is that you just shouldn't use DOS while using 
interrupts - even with a clock card! The only real 
solution is to modify the F8 Monitor ROM so that 
location $45 isn't destroyed by an interrupt. This 
solves all the problems at once, and is described in 
Appendix B. 
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APPENDIX B: MODIFIED F8 ROM OPTION 



There are two ways of looking at (and solving) the 
problem of the conflict between DOS and the Monitor s 
use of location $45 and the Monitor's IRQ handler. 

Modifying DOS 3.3 and the Monitor ROM 

The first is to say that DOS and the Monitor should not 
use location $45 for their general routines. You could 
alter the Monitor and DOS to solve this. The main 

problems here are that in addition to altering the 
Monitor ROM (also called the F8 ROM) you must also 
modify DOS 3.3 to eliminate all uses of location $45 and 
then boot on this custom version of DOS. If you are 
running software off another diskette that you must boot 
on, you will not be able to run your interrupt software 
at the same time. 

In addition, ProDOS checks the Monitor on boot, and 
will not boot on your modified Monitor ROM. 

Modifying just the Monitor ROM IRQ Routine 

The other option is to again alter the Monitor, but in 
this case, only change the IRQ handler so as to not 
destroy location $45. This still suffers from the 
problem of the ProDOS boot check, but does eliminate the 
need for a custom DOS 3.3, and avoids conflict with 
programs that others may write that use location $45 as 
a temporary register. 

Let's take a second look at how the Monitor (Auto-Boot 
version ) usually handles an interrupt: 



FA40- 


85 


45 




STA 


$45 


5 


save Acc. 


FA42- 


68 






PLA 




7 


retrieve Status Reg. 


F A4 3 — 


48 






PHA 




7 


copy Status to stack: 


FA44- 


OA 






ASL 








FA45- 


OA 






ASL 








FA46- 


OA 






ASL 




9 


shift xnt fig to N 


FA4 7- 


30 


03 




BMI 


$ F A4 C 


7 


branch if BRK 


FA49- 


6 C 


FE 


03 


JMP 


( $3 FE ) 


9 


JMP via vector 


FA4C- 


28 






PLP 




7 


retrieve Status Reg. 


FA4D- 


20 


4 C 


FF 


JSR 


$ FF4C 


t 


save regs (not Acc. ) 
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The first thing that happens when an interrupt occurs is 
that the Accumulator is stored in location $45. This is 
the source of the location $45 conflict under inter- 
rupts. After testing the BRK flag, the routine then 
either jumps to an address pointed to by $3FE,3FF (if an 
interrupt) or falls through to $FA4C to process the BRK 
instruction . 



Suppose for a moment that we were to re-write this part 
of the Monitor to read as follows: 



FA40- 


6C 


FE 03 


JMP 


( $3FE) 


$ 


jump to interrupt 
routine. 


FA43- 


85 


45 


STA 


$45 


J 


save acc* 


FA45- 


68 




PLA 




i 


retrieve Status Reg. 


FA46- 


48 




PHA 




> 


restore stack 


FA47- 


OA 




ASL 








FA48- 


OA 




ASL 








FA4 9- 


OA 




ASL 




l 


shift BRK flag into 
sign bit 


FA4A- 


10 


13 


BPL 


$ F A5 F 




branch to a jump to 
the Monitor 


FA4C- 


28 




PLP 




* 


retrieve Status Reg* 



(beg. of BRK routine) 



In this version, we jump immediately to our own inter- 
rupt routine pointed to by $3FE,3FF, and can then save 
the Accumulator in a location of our own chosing, and 
that is presumably more compatible with the rest of the 
Apple (such as the internal storage locations used by 
routines in this package). 

Under normal condition, DOS stores the address $.FF65 in 
locations $3FE,3FF during the boot process. This 
points to the jump-to-monitor routine in the Apple 
Monitor. ($FF65 is roughly the same as a CALL -151 
from BASIC) . 

With the modified ROM, if an interrupt is received, 
control immediately goes to $FA40 (via the vector at 
$FFFE,FFFF), which then jumps via the vector at 
$ 3 FE , 3 F F . With locations $3FE,3FF set to their boot-up 
address ($FF65), control is then passed to $FF65 with 
the result being a jump to the Monitor (without the 

"beep!" 1234- A=00 X=23 Y=FF P=DE S=67 

type of message). 
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If you do not modify DOS, then the instructions from 
$ F A4 3 through $FA4C will never be executed, and BRKs 
will be treated just like IRQs, i.e. an immediate jump 
to the Monitor with no particular message. (Remember 
that both IRQs and BRKs are vectored to $FA40 by the 
bytes at $FFFE,FFFF). 

By modifying DOS on the disk, you can make DOS set 
$3FE,3FF to point to $FA43 instead of $FF65 at boot-up 
t ime . 

To modify DOS on a disk, you can use a disk editing 
utility to change bytes $7F and $80, track 0, sector $0D 
from $65, FF to $43, FA. You can also change locations 
$9E7F,9E80 in memory from $65, FF to $43, FA and then 
initialize a blank disk. 

Locations $3FE,3FF can also be set to point to $FA43 
with a set of POKEs (or STA's) at any time after boot up 
as well. In that case, the instructions from $FA43 
through $ FA4C will handle BRK instructions and 
interrupts just as the unmodified Monitor ROM would, 
i.e. Monitor messages on a BRK, and a message-less jump 
to Monitor on an IRQ. 

IMPLEMENTING THE F8 ROM MODIFICATIONS 

The usual way of modifying part of the ROM in the Apple 
is to program an EPROM (Erasable Programmable Read Only 
Memory) with the new version of the software that 
usually occupies that portion of memory. This is done 
using "EPROM Burner" and requires some special 
equipment . 

If you are not familiar with, or do not have access to 
this technique, you may want to consider purchasing a 
pre-programmed substitute F8 ROM chip, which is 
described in the following section, "DOUBLETIME PRINTER 
OFFER" . 

If you do want to program your own EPROM, just substi- 
tute the code listed above in the range of $FA40 through 
$FA4C for the equivalent bytes in the normal F8 Monitor 
ROM code. 

A couple of notes here. First, the ROMs that the Apple 
II/II+ use are almost, but not quite, compatible with 
the popular 2716 EPROM (Eraseable Programmable Read 
Only Memory). The difference is in the polarity of the 
signals on pins 18 and 21. To our knowledge there are 
five ways to get around this incompatibility. 
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1) Bend up pins 18 and 21 and solder them to wires 
running to pins 24 and 12, respectively. This is not 
recommended because it overrides the Inhibit signal 
that turns off the ROM addresses. 

2) Wire an adapter that passes through all signals 
except those on pins 18 and 21, and cross wire those so 
that the signal that is on pin 18 of the APPLE socket 
appears on pin 21 of the EPROM and vice versa. This 
system works most of the time on most Apples, but may 
not work with all RAM cards. The reason for this 
problem is that Apple uses pin 18 for INHIBIT to keep 
the ROMs from being enabled when the ROM address space 
is being used by a ROM or RAM card. Pin 21 on the 2716 
EPROM is not a timed signal. The 2716 expects to see a 
solid 5 volts. Inhibit i_s a timed signal, and thus 
can be "missed" by the 2716. 

3) The PROMETTE by Computer Microworks, Inc, P.0. Box 
33651, Dayton, Ohio, 45433, (305) 777-0268 is a socket 
for 2716s that has an inverter chip on board that 
"fixes” the signals to make 2716s Apple compatible. 

4) Have a chip manufacturer make a special ROM chip to 
your specifications. This has the drawbacks of costing 
over $1500 and taking three months. 

5) Take advantage of the DOUBLETIME PRINTER OFFER 
mentioned in this manual. This includes an Apple 
compatible ROM already programmed to fix the IRQ 
location $45 problem. The only disadvantage here is 
that ProDOS checks to see if the F8 ROM is an "official" 
Apple ROM when it boots, and if the ROM doesn't check 
out (i.e. not identical to the usual F8 AutoBoot ROM), 
ProDOS won't boot. Not very nice on their part. 

There is a patch to this however. If you have a ProDOS 
track/sector edit utility that lets you change data on 
the diskette, change bytes $60-61 on track 1, sector 9 
from $A9 00 to $A5 0C. This disables the ROM check 
routine. 

It may also be necessary to change track 1, sector $C, 
bytes $B4-B6 from AE B3 FB to A2 EA EA. This tells 
ProDOS that your computer is a II+. Making byte $B5 an 
$A0 tells it you have a //e. 
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PROGRAMMING INTERRUPT ROUTINES 
WITH THE MODIFIED ROM 

Using the modified ROM gives the interrupt programmer 
more freedom in preserving and restoring registers. 
The interrupt routine, whose address is stored at 
$3FE , 3FF , must save all registers it uses and must 
determine whether it has been called by an IRQ or a 
BRK. (See the code at $FA43 for the technique to do 
this . ) 

Just remember to save and restore the Accumulator froma 
location not used by the foreground task. Don't 
restore the Accumulator from location $45 if you re 
using a modified ROM. Do restore it from $45 if your 
ROM is the Apple standard Monitor ROM. 



THE UNIVERSAL INTERRUPT RETURN 

The listing on the next page is a listing for an 
alternate exit for interrupt routines so that they will 
work on either standard or modified (as described above) 
F8 Monitor ROMs. In altering any of the source listings 
in this kit for example, you would just replace every- 
thing from the label RETURN on down in each source 
listing with the RETURN routine listed here. 

The idea behind this return technique is to test 
location $FA40 in the Monitor to see if the byte there 
corresponds to a standard or the modified F8 ROM. If 
location $FA40 holds the value $85, it is a standard 
ROM, and the routine falls through the branch to load 
the Accumulator with the contents of location $45 
before returning with the usual RTI. 

If location $FA40 isn't equal to $85, the Monitor is 
probably a modified ROM, and so the routine branches to 
RETURN1 where the Accumlator is restored using the 
internal storage location SAVREGS. 

When altering your routines to use the universal 
interrupt return, you do have to remember to store the 
contents of the accumulator in SAVREGS or its equivalent 
at the entry to your routine. This already done for you 
in all the listings in this kit, so it is only necessary 
to add the new RETURN routine at the end of them. 
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******************************** 

* UNIVERSAL INTERRUPT RETURN * 
******************************** 



1 

2 

3 

4 

5 

6 

7 

8 

9 



0300 : 


00 






10 










1 1 


0301 : 


AD 


40 


FA 


12 


0304 : 


C9 


85 




13 


0306 : 


DO 


03 




14 


0308: 


A5 


45 




15 


030 A ; 


40 






16 










17 


030B : 


AD 


00 


03 


18 


030 E : 


40 






19 





ORG 


$300 




OBJ 


$300 


MON IRQ 


EQU 


$ F A4 0 


SAVREGS 


SEX 


00 


RETURN 


EDA 


MONIRQ 




CMP 


#$8 5 




BNE 


RETURN1 




LDA 

RTI 


$45 


RETURN1 


LDA 


SAVREGS 


RETURN2 


RTI 





; ADDR. OF MONITOR 
IRQ ROUTINE 

; STORE ACC. 

; CHECK MONITOR ROM 
; IS THIS DBLTM ROM? 
; YES ! 

; RESTORE A 



; RESTORE ACC FROM 
SAVREG 
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DOUBLETIME PRINTER OFFER 



(Apple II/II+ only) 

If you have an Apple II or 11+ (not //e or / /c) and 
don't want to make your own EPROM, or want to avoid the 
possible problems related to EPROMs and RAM cards, we 
have a special offer to purchasers of The Interrupt 
Experimenter's Kit. 

Doubletime Printer is an interrupt driven print spooling 
package that will print files from disk under DOS 3.3 
while you are running a program in the foreground. You 
can even list Applesoft programs directly from disk. 

The product also includes a special modified F8 ROM 
that has the interrupt routine patch described in this 
section. Since it's a ROM you don't have to worry 
about problems with RAM cards, and we also fixed the 
lower case input problem while we were changing things. 

This means that when you copy over lower case text on 
the screen, it won't be converted to upper case. Also, 
when the cursor is on an upper case letter on the 
screen, it will be displayed as an inverse capital 
letter, as opposed to the strange %@#&, etc. characters 
that the usual Apple II/II+ machines display. 

Doubletime Printer comes with the modified F8 ROM, a 70 
page instruction manual, and a diskette with the Double- 
time Printer software. 



To receive your Doubletime Printer package, send a 
check or money order for $25 .00 ($28.00 in Calif.) tot 



Doubletime Printer Special 
Roger Wagner Publishing, Inc. 
P.0. Box 582-1 
Santee, CA 92071 
(619) 562-3670 



You can also use Mastercharge and Visa, just be sure to 
include your expiration date and card number with your 
order . 
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APPENDIX C: EXTRA DEMONSTRATION PROGRAMS 



There are a number of other demonstration programs 
provided on The Interrupt Experimenter's Kit diskette. 

They are: 

1) LO-RES COLOR SHIFTER: RUN the program LORES 
PROGRAM to see how an interrupt driven routine can be 
combined with Applesoft. 

The screen image should change colors as the 
interrupt routine changes every color pixel every 10th 
of a second or so. Notice that you can type anything 
you want in the window at the bottom of the screen, 
including any normal Applesoft command like PRINT 
"HELLO”, LIST, etc. while the interrupts operate on the 
screen "in the background". Press RESET to stop the 
interrupts and return the screen to the normal TEXT 
mode. 



You may also want to re-assemble the routine with a 
faster (less than 20) RATE value to speed up the screen 
action, and observe the corresponding slowing down of 
the foreground operations. You can also try changing 
the RATE value by adding a POKE 779 , K to the LORES 
PROGRAM (at line 45 for example), where K is a number 
between 1 and 50 that determines the rate of the screen 
cycles • 

2) PONG: BRUN PONG from the immediate mode of 
Applesoft. The bottom portion of the screen will be 
protected from normal scrolling, and a "ball” will 
bounce around inside the box that is drawn at the bottom 
of the screen. Again, notice that you can LIST 
programs, etc. Pressing RESET will stop the interrupt 
program. 

3) BOUNCER: This is similar to the PONG program, 
except in this case a border is not drawn on the screen, 
and the "ball” is free to bounce anywhere on the screen 
while you LIST your program, CATALOG the disk, etc. 
When the screen scrolls, the ball leaves a trail because 
the program cannot erase the ball when it draws a new 
one. This is because the interrupt program has no way 
of knowing that the screen has scrolled. Remember that 
interrupt programs are generally independent of any 
foreground programs or activities that are going on. 
Pressing RESET will stop the BOUNCER program. 
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1 ******************************** 

2 * INTE RRUPT DRIVEN COLOR DISPLAY* 

3 * 1/21/85 * 

4 ******************************** 

5 

6 * CHANGES PLOTTED COLORS ONLY ON A LORES 

SCREEN 

7 











8 


IRQ 


EQU 


$ 3 FE 












9 


PTR 


EQU 


$6 


; Z-PG LOCS $06,07 










10 


MONIRQ 


EQU 


$ F A4Q 


; LOC OF NORMAL MON 


















IRQ ROUTINE 










11 


















12 




OBJ 


$300 












13 




ORG 


$300 












14 


















15 


* SET UP 


INTERRUPT VECTOR 










16 










0300 : 


A9 


IE 




17 


INIT 


LDA 


tf< START 


; LO BYTE OF IRQ 
ROUTINE ADDRESS 


0302 : 


8D 


FE 


03 


18 




STA 


IRQ 


; PUT IN LO BYTE OF 
VECTOR 


0305 : 


A9 


03 




19 




LDA 


OS TART 


; HI BYTE OF IRQ 
ROUTINE ADDRESS 


0307 : 


8D 


FF 


03 


20 




STA 


IRQ+1 


; PUT IN HI BYTE OF 
VECTOR 


0 30 A : 


A9 


IE 




21 




LDA 


it 20 


; it OF INTS TO WAIT 
PER CYCLE 


0 30 C : 


8D 


17 


03 


22 




STA 


RATE 


; INITIALIZE RATE = 
20 


030 F : 


8D 


18 


03 


23 




STA 


TIME 


; SET TIME TO RATE 










24 


















25 


* ENABLE 


INTS 


. AND TURN 


ON CARD 










2 6 










0312 : 


58 






27 




CL I 




; ENABLE INTERRUPTS 


0313 : 


AD 


CO 


CO 


28 




LDA 


$C0C0 


; $ CO ( 8 + N } 0 = TURN 


















ON CARD 


0316 : 


60 






29 




RTS 




j STARTUP DONE! 










30 


















31 


* VARIABLES 














32 










0 317: 


00 






33 


RATE 


HEX 


00 


; it OF INTS PER 
SCREEN CYCLE 


0318 : 


00 






34 


TIME 


HEX 


00 


; CURRENT INT it 
COUNTER 


0319 : 


00 






35 


VALUE 


HEX 


00 


; TEMP VALUE FOR A 
NIBBLE 


03 1 A : 


00 






36 


YP 


HEX 


00 


; Y POSN ON SCREEN 
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0 3 1 B : 
0 3 1 C : 
03 ID : 

03 IE : 

0321 : 
0324 : 

0327 : 
032A: 

03 2 C : 
032F : 

0332 : 

0334: 



0337 : 

0 3 3 A : 

0 3 3D : 
0 3 3 F : 

0342 : 
0344: 



0346 : 

0348: 
0 3 4A : 



00 






38 


SAVREGS 


HEX 


00 


> 


LOCATION TO SAVE 




















ACC . 


00 






39 






HEX 


00 


1 


LOCATION TO SAVE 
X-REGISTER 


00 






40 






HEX 


00 


> 


LOCATION TO SAVE 
Y-REGISTER 








41 














8D 


IB 


03 


42 


START 


STA 


SAVREGS 


> 


SAVE ACCUMULATOR 




















VALUE 


8 E 


1C 


03 


43 






STX 


SAVREGS+1 


3 


SAVE X REG 


8 C 


ID 


03 


44 






STY 


SAVREGS+2 


? 


SAVE Y REG 








45 




















46 


* 


DEC TIME. : 


READY YET? 












47 


k 


IF SO 


, RESET TIME COUNT 




& CONT 








48 


k 


ELSE, 


RETURN 












49 














CE 


18 


03 


50 






DEC 


TIME 


3 


TIME = TIME - 1 


DO 


49 




51 






BNE 


RETURN 


5 


BACK. TO FOREGROUND 
IF NOT DONE 


AD 


17 


03 


52 






LDA 


RATE 


5 


GET 'RATE' VALUE 


8D 


18 


03 


53 






STA 


TIME 


J 


RESTORE 'TIME' 
COUNTER 


A9 


13 




54 






LDA 


#19 


3 


19 = LAST LINE ON 
GR SCREEN 


8D 


1A 


03 


55 






STA 


YP 


3 


SET YP TO LINE 19 








56 




















57 


k 


MAIN 


LOOP 


m 

« 












58 


k 


FIRST 


GET 


BASE ADDRESS 


FOR 








59 


* 


YPOS , 


THEN 


LOOP ACROSS 












60 


k 


ROW . 


WHEN 


DONE, GOTO NEXT 








61 


k 


YPOS 


POSITION. 












62 














AG 


1A 


03 


63 


GL 


LDY 


YP 


3 


GET LINE # TO WORK 




















ON 


B 9 


89 


03 


64 






LDA 


ADDRLO , Y 


3 


GET LO BYTE OF 
BASE ADDRESS 


85 


06 




65 






STA 


PTR 


> 


PUT IN PTR 


B9 


A1 


03 


66 






LDA 


ADDRHI , Y 


J 


GET HI BYTE OF 
BASE ADDRESS 


85 


07 




67 






STA 


PTR+1 


) 


PUT IN PTR+1 


AO 


27 




68 






LDY 


#39 


J 


SET Y = END OF 
SCREEN LINE 








69 




















70 


k 


DO EACH NIBBLE AT A TIME 










71 


k 


DEC THE NIBBLE. IF 0, RESET 








72 


k 


TO $ F 


(15) 


• 












73 














81 


06 




74 


GTOP 


LDA 


(PTR) , Y 


3 


GET SCRN VALUES 




















FOR TOP & BOTTOM 


FO 


23 




75 






BEQ 


NXTBLK 


$ 


SKIP IF BOTH BLACK 


29 


OF 




76 






AND 


#$0 F 


3 


LOOK AT TOP BLOCK 



44 



0 34 C ; 


8D 


19 


03 


77 






STA 


VALUE 


; SAVE TOP VALUE 


0 34F ; 


F0 


OA 




78 






BEQ 


GBOTM 


; SKIP IF BLACK 


0351 : 


CE 


19 


03 


79 






DEC 


VALUE 


; COLOR = COLOR - 1 


0354: 


DO 


05 




80 






BNE 


GBOTM 


; IF NOT BLACK 


0356: 


A9 


OF 




81 






LDA 


# $ of 


; SET BACK TO 15 = 
WHITE 


0358 : 


8D 


19 


03 


82 






STA 


VALUE 


; SAVE VALUE 










83 












035B : 


B1 


06 




84 


GBOTM 


LDA 


( PTR) , Y 


; GET BYTE AGAIN 


035D : 


29 


FO 




85 






AND 


#$ FO 


; LOOK AT BOTTOM 
BLOCK 


0 3 5F : 


FO 


07 




86 






BEQ 


MIX 


; FINISH IF BLACK 


0361 : 


38 






87 






SEC 






0362 : 


E9 


10 




88 






SBC 


#$10 


; COLOR = COLOR - 1 
(NO - 10) 










89 










; REMEMBER THIS IS 
BECAUSE 










90 










; WE'RE DOING THE 
UPPER NIBBLE 


0364 : 


DO 


02 




91 






BNE 


MIX 


; IF NOT BLACK 


0366 : 


A9 


FO 




92 






LDA 


# $ FO 


; RESET TO BLACK 










93 












0368: 


OD 


19 


03 


94 


MIX 


ORA 


VALUE 


; ENTER WITH ACC - 




















BOTTOM NIBBLE 


036B : 


91 


06 




95 






STA 


(PTR) ,Y 


; PUT NEW COLOR ON 
SCREEN 










96 




















97 


* 


END 


OF LOOP 


FOR X LOOP 












98 


* 


AND 


Y LOOP. 














99 












036D : 


88 






100 


NXTBLK 


DEY 




; Y = Y - 1 FOR NEXT 




















HORIZ. POSN. 


0 3 6 E : 


10 


D6 




101 






BPL 


GTOP 


; DO NEXT BOX IF NOT 
DONE 


0370: 


CE 


1A 


03 


102 






DEC 


YP 


; YP = YP - 1 FOR 
NEXT SCREEN LINE 


0373 : 


10 


C2 




103 






BPL 


GL 


; PROCESS NEXT LINE 
IF NOT DONE 










104 




















105 


* 


WHEN 


DONE RESTORE REGISTERS 










106 


* 


AND 


RETURN 














107 












0375 : 


AE 


1C 


03 


108 


RETURN 


LDX 


SAVREGS+1 


j RESTORE X REGISTER 


0378: 


AC 


ID 


03 


109 






LDY 


SAVREGS+2 


; RESTORE Y REGISTER 


0 3 7B : 


AD 


40 


FA 


110 






LDA 


MON IRQ 


; CHECK MONITOR ROM 




















ID BYTE 


037E : 


C9 


85 




111 






CMP 


#$8 5 


; DBLTM ROM? 


0380 : 


DO 


03 




112 






BNE 


RETURN1 


; YES ! 


0382 : 


A5 


45 




113 






LDA 


$45 


; RESTORE ACC. FROM 

t r\n £ c 



45 



0384: 


40 






1 14 




RTI 










1 15 






0385 : 


AD 


IB 


03 


116 


RETURN1 


LDA 


0388 : 


40 






117 


RETURN2 


RTI 










118 














1 19 


** ADDRESSES 










120 






0389 : 


00 


80 


00 


121 


ADDRLO 


HEX 


0 38C : 


80 


00 










038E : 


80 


00 


80 


122 




HEX 


039 I : 


28 


A8 










0393 : 


28 


A8 


28 


123 




HEX 


0396: 


A8 


28 










0398 : 


A8 


50 


DO 


124 




HEX 


039B : 


50 


DO 










0 39 D : 


50 


DO 


50 


125 




HEX 


03A0 : 


DO 












03A1 : 


04 


04 


05 


126 


ADDRHI 


HEX 


03A4 : 


05 


06 










03A6 : 


06 


07 


07 


127 




HEX 


0 3 A9 : 


04 


04 










0 3 AB : 


05 


05 


06 


128 




HEX 


0 3 AE : 


06 


07 










0 3 BO: 


07 


04 


04 


129 




HEX 


03B3 : 


05 


05 










03B5 : 


06 


06 


0 7 


1 30 




HEX 


0 3B8 : 


07 













; RETURN FROM THE 
INTERRUPT 

SAVREGS ; RESTORE ACC FROM 

SAVREGS 

; RETURN FROM THE 
INTERRUPT 

OF 1ST BYTE OF EACH SCREEN LINE 
0080008000 
80008028A8 
28A828A828 
A850D050D0 
50D050D0 
0404050506 
0607070404 
0505060607 
0704040505 
06060707 
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1 * ************************* ****** 

2 * INTERRUPT DRIVEN PONG * 

3 * 1/21/85 * 

4 ******************************** 

5 











6 


IRQ 


EQU 


$ 3FE 












7 


PTR 


EQU 


$06 


; $06,07 










8 


BOTTOM 


EQU 


$23 












9 


MON IRQ 


EQU 


$ F A40 












10 


SPKR 


EQU 


$ CO 30 












11 


HOME 


EQU 


$ FC5 8 












12 


















13 




ORG 


$8000 












14 


















15 


* SET INT. VECTORS 












16 


* CLEAR 


SCREES 


[ AND SET TEXT WIND. 










17 


* SET X 


& Y DELTAS, X 6 


Y POS , 










18 


* AND DRAW INVERSE BORDER 










19 










8000: 


A9 


91 




20 


INIT 


LDA 


#< START 


; LO BYTE OF IRQ 
ROUTINE ADDR. 


8002 : 


8D 


FE 


03 


21 




STA 


IRQ 


; PUT IN LO BYTE OF 
VECTOR 


8005 : 


A9 


80 




22 




LDA 


#>S TART 


; HI BYTE OF IRQ 
ROUTINE 


8007 : 


8D 


FF 


03 


23 




STA 


IRQ+1 


; PUT IN HI BYTE OF 
VECTOR 


800 A : 


20 


58 


FC 


24 




JSR 


HOME 


; CLEAR SCREEN & 
HOME CURSOR 


800D : 


A9 


OF 




25 




LDA 


7/15 


; 15 = TOP OF "GAME 

AREA 


800F : 


85 


23 




26 




STA 


BOTTOM 


; SET TEXT SCROLL 
WINDOW 


8011 : 


A 9 


FF 




27 




LDA 


#$FF 


; #$FF = -1 IN 2'S 
COMPLEMENT MATH 


8013 : 


8D 


89 


80 


28 




STA 


XD 


; SET X VELOCITY = 

-1 

; SET Y VELOCITY = 

_ i 


8016 : 


8D 


8 A 


80 


29 




STA 


YD 


8019 : 


A9 


14 




30 




LDA 


#20 


.L 

; # OF INTS PER 

CYCLE 


80 IB : 


8D 


85 


80 


31 




STA 


RATE 


; SET RATE VALUE 


80 IE : 


8D 


86 


80 


32 




STA 


TIME 


; SET TIME = RATE 


8021 : 


A9 


14 




33 




LDA 


#2 0 


; STARTING X,Y POSN 
FOR BALL 


8023 : 


8D 


87 


80 


34 




STA 


XPOS 


; X POSN = 20 


8026 : 


8D 


88 


80 


35 




STA 


YPOS 


; Y POSN = 20 


8029 : 


A9 


27 




36 




LDA 


#3 9 


; 39 = RT SIDE OF 
SCREEN 


802B : 


8D 


8C 


80 


37 




STA 


XP 


; SET UP TO DRAW 



WALLS 



4 7 



802E : 


A9 


OF 




38 




LDA 


8030 : 


8D 


8D 


80 


39 




STA 


8033 : 


A9 


20 




40 




LDA 


8035: 


8D 


8B 


80 


41 




STA 










42 






8038 : 


20 


5D 


81 


43 


DRAWTOP 


JSR 


80 3B : 


CE 


8C 


80 


44 




DEC 


8 0 3 E : 


10 


F 8 




45 




BPL 


8040 : 


A9 


27 




46 




LDA 


8042 : 


8D 


8C 


80 


47 




STA 


8045 : 


A9 


17 




48 




LDA 


8047: 


8D 


8D 


80 


49 




STA 










50 






804 A : 


20 


5D 


81 


51 


DRAWBTM 


JSR 


804D : 


CE 


8 C 


80 


52 




DEC 


8050 : 


10 


F8 




53 




BPL 


8052 : 


A9 


00 




54 




LDA 


8054 : 


8D 


8C 


80 


55 




STA 


8057 : 


A9 


10 




56 




LDA 


8059 : 


8D 


8D 


80 


57 




STA 










58 






80 5 C : 


20 


5D 


81 


59 


DRAWLFT 


JSR 


80 5 F : 


EE 


8D 


80 


60 




INC 


8062 : 


AD 


8D 


80 


61 




LDA 


8065: 


C9 


19 




62 




CMP 


8067 : 


DO 


F 3 




63 




BNE 


8069 : 


A9 


27 




64 




LDA 


806 B : 


8D 


8C 


80 


65 




STA 


806E : 


A9 


10 




66 




LDA 


8070 : 


8D 


8D 


80 


67 




STA 


8073 : 


20 


5D 


81 


68 


DRAWRT 


JSR 


8076 : 


EE 


8D 


80 


69 




INC 


8079 : 


AD 


8D 


80 


70 




LDA 


80 7 C : 


C9 


19 




71 




CMP 


807E: 


DO 


F3 




72 




BNE 










73 







#15 


; 15 = TOP OF "GAME" 

AREA 


YP 


; SET UP TO DRAW 
WALLS 


#$20 


; VALUE FOR AN 
INVERSE BOX 


VALUE 


; VALUE FOR PLOT 
ROUTINE 


PLOT 


; DRAW TOP WALL 


XP 


; XP = XP - 1 UNTIL 
DONE 


DRAWTOP 


; LOOP FOR A LINE 


#3 9 


; 39 = RT EDGE OF 

SCREEN 


XP 


; XP = 39 


#23 


; 23 = BOTTOM OF 

SCREEN 


YP 


; YP = 23 


PLOT 


; DRAW BOTTOM WALL 


XP 


; XP = XP - 1 UNTIL 
DONE 


DRAWBTM 


; LOOP FOR A LINE 


#0 


; 0 FOR LEFT EDGE OF 
SCREEN 


XP 


; XP “ 0 


#16 


; 16 = LINE FOR TOP 

OF WALL 


YP 


; YP = 16 


PLOT 


; DRAW THE LEFT WALL 


YP 


; YP - YP + 1 


YP 


; GET VALUE TO CHECK 


#2 5 


; 25 = BOTTOM OF 
SCREEN + 1 


DRAWLFT 


; DRAW UNTIL DONE 


#39 


; 39 = RT SIDE OF 
SCREEN 


XP 


; XP = 39 


#16 


; 16 = LINE FOR TOP 

OF WALL 


YP 


; YP = 16 


PLOT 


; DRAW THE RT SIDE 
WALL 


YP 


; YP = YP + 1 


YP 


; GET VALUE TO CHECK 


#2 5 


; 25 = BOTTOM OF 

SCREEN + 1 


DRAWRT 


; DRAW UNTIL DONE 



48 











74 


* ENABLE 


INTS . 


AND ACTIVATE 


CARD 










75 












8080 : 


58 






76 




CL I 




9 


ENABLE INTERRUPT 
FLAG 


8081 : 


AD 


CO 


CO 


77 




LDA 


$C0C0 


9 


$ CO ( 8 + N )0 = TURN 
ON CARD 


8084 : 


60 






78 




RTS 




9 


STARTUP IS DONE! 










79 




















80 


* VARIABLES 
















81 












8085 : 


00 






82 


RATE 


HEX 


00 


9 


# OF INTS PER 
SCREEN CYCLE 


8086 : 


00 






83 


TIME 


HEX 


00 


9 


CURRENT INT // 
COUNTER 


8087 : 


00 






84 


XPOS 


HEX 


00 


9 


CURRENT X POSN OF 
BALL 


8088: 


00 






85 


YPOS 


HEX 


00 


9 


CURRENT Y POSN OF 
BALL 


8089 : 


00 






86 


XD 


HEX 


00 


9 


VALUE FOR X 
VELOCITY 


808A: 


00 






87 


YD 


HEX 


00 


9 


VALUE FOR Y 
VELOCITY 


8 0 8 B : 


00 






88 


VALUE 


HEX 


00 


9 


VALUE FOR PLOT 
ROUTINE TO DRAW 


808C : 


00 






89 


XP 


HEX 


00 


> 


X COORDINATE FOR 
PLOT ROUTINE 


808D : 


00 






90 


YP 


HEX 


00 


) 


Y COORDINATE FOR 
PLOT ROUTINE 


8088 : 


00 






91 


SAVREGS 


HEX 


00 


9 


LOCATION TO SAVE 
ACC 


80 8 F : 


00 






92 




HEX 


00 


9 


LOCATION TO SAVE 
X-REG 


8090: 


00 






93 




HEX 


00 


9 


LOCATION TO SAVE 
Y-REG 










94 




















95 


* DISABLE INTS. & SAVE 


REGS 










96 












8091 : 


8D 


8E 


80 


97 


START 


STA 


SAVREGS 


9 


SAVE ACCUMULATOR 


8094 : 


8E 


8F 


80 


98 




STX 


SAVREGS+1 


\ 


SAVE X REGISTER 


8097 : 


8C 


90 


80 


99 




STY 


SAVREGS+2 


9 


SAVE Y REGISTER 










100 




















101 


* TIMER 


TIMED 


OUT? 














102 


* IF NOT 


, RETURN. IF SO 


, RESET 










103 


* TIMER 


& CONTINUE 














104 












809 A : 


CE 


86 


80 


105 




DEC 


TIME 


9 


TIME = TIME - 1 


809D : 


DO 


6C 




106 




8NE 


RETURN 


» 


RETURN TO 
FOREGROUND IF NOT 
DONE 


80 9 F : 


AD 


85 


80 


107 




LDA 


RATE 


1 


GET 'RATE' VALUE 



49 



80A2 : 


8D 


86 


80 


108 






STA 


TIME 


; RESTORE TIME 




















COUNTER 










109 




















110 


* 


ERASE 


BALL 














111 












80A5 : 


A9 


AO 




112 






LDA 


#" " 


; SPACE CHARACTER 


80A7 : 


8D 


8B 


80 


113 






STA 


VALUE 


; PUT IN VALUE FOR 




















PLOT 


80AA : 


AD 


87 


80 


114 






LDA 


XPOS 


; GET CURRENT X POSN 




















OF BALL 


80AD : 


8D 


8C 


80 


115 






STA 


XP 


; XP = XPOS 


80B0 : 


AD 


88 


80 


1 16 






LDA 


YPOS 


; GET CURRENT Y POSN 




















OF BALL 


8 0B3 : 


8D 


8D 


80 


117 






STA 


YP 


; YP = YPOS 


SOB 6 : 


20 


5D 


81 


118 






JSR 


PLOT 


; ERASE THE BALL 










119 




















120 


* 


ADD DELTAS 


TO CURRENT 


POSITION 










121 












80B9 : 


AD 


87 


80 


122 


NEWX 


LDA 


XPOS 


; GET CURRENT X POSN 




















OF BALL 


80 BC : 


18 






123 






CLC 




; CLEAR CARRY FOR AN 
ADD 


80BD : 


6D 


89 


80 


124 






ADC 


XD 


; ADD X VELOCITY 










125 




















126 


& 


CHECK 


FOR HITTING BOUNDARIES 










127 


* 


IF THEY HIT 


, REVERSE 


DELTA 










128 


A 


DIRECTION 














129 












80C0 : 


FO 


OA 




130 






BEQ 


RVRSX 


; IF X = 0 THEN 
REVERSE 


80C2 : 


C9 


27 




131 






CMP 


it 39 


; 39 = RIGHT WALL 


80C4 : 


FO 


06 




132 






BEQ 


RVRSX 


; REVERSE IF THERE 


80C6 : 


8D 


87 


80 


133 






STA 


XPOS 


; PUT VALUE BACK IF 
OK 


8QC9 : 


4C 


D7 


80 


134 






JMP 


NEWY 


; CALCULATE NEW Y 
POSN 


80 CC : 


AD 


89 


80 


135 


RVRSX 


LDA 


XD 


; GET X VELOCITY 


80 CF : 


49 


FE 




136 






EOR 


# $FE 


; XD = XD * -1 TO 
REVERSE MOTION 


80D1 : 


8D 


89 


80 


137 






STA 


XD 


; PUT BACK 


80D4 : 


20 


4F 


81 


138 






JSR 


SOUND 


; MAKE THE 'BOUNCE' 
NOISE 










139 












SOD 7 : 


AD 


88 


80 


140 


NEWY 


LDA 


YPOS 


; GET CURRENT Y POSN 




















OF BALL 


SODA: 


18 






141 






CLC 




; CLEAR CARRY FOR AN 
ADD 


80DB : 


6D. 


8 A 


80 


142 






ADC 


YD 


; ADD Y VELOCITY 
VALUE 


80DE : 


C9 


OF 




143 






CMP 


it 15 


; 15 = TOP WALL 



50 



80E0 : 

80E2 : 
80E4 : 

80E 6 ; 

8 0E9 : 

80EC : 

80EF : 

80 F 1 : 
80F4 : 

80F 7 : 
80FA : 
8 OFD : 
8100 : 
8103: 
8105 : 
8108 : 

8 1 OB : 
8 1 OE : 
8111: 
8114: 
8116: 
8118: 

81 1A: 

81 IB : 
81 IE : 



FO 


OA 




144 




BEQ 


RVRSY 


; REVERSE VELOCITY 














IF THERE 


C9 


17 




145 




CMP 


#2 3 


; 23 = BOTTOM WALL 


FO 


06 




14 6 




BEQ 


RVRSY 


; REVERSE VELOCITY 
IF THERE 


8D 


88 


80 


147 




STA 


YPOS 


; PUT BACK IF VALUE 
OK 


4C 


F7 


80 


148 




JMP 


DRAW 


; DRAW THE NEW BALL 
IMAGE 


AD 


8 A 


80 


149 


RVRSY 


LDA 


YD 


; GET CURRENT Y 
VELOCITY 


49 


FE 




150 




EOR 


# $ FE 


; YD = YD * -1 TO 
REVERSE MOTION 


8D 


8A 


80 


151 




STA 


YD 


; PUT BACK NEW 
VELOCITY 


20 


4 F 


81 


152 




JSR 


SOUND 


; MAKE THE 'BOUNCE' 
NOISE 








153 
















154 


* FINALLY, DRAW THE BALL 










155 










AD 


87 


80 


156 


DRAW 


LDA 


XPOS 


; GET CURRENT X POSN 
OF BALL 


8D 


8C 


80 


157 




STA 


XP 


; PUT IN XP FOR PLOT 
ROUTINE 


AD 


88 


80 


158 




LDA 


YPOS 


; GET CURRENT Y POSN 
OF BALL 


8D 


8D 


80 


159 




STA 


YP 


; PUT IN YP FOR PLOT 
ROUTINE 


A9 


CF 




160 




LDA 


# " 0 " 


; CHARACTER FOR THE 
BALL 


8D 


8B 


80 


161 




STA 


VALUE 


; PUT IN VALUE TO 
PLOT 


20 


5D 


81 


162 




JSR 


PLOT 


; DRAW THE NEW BALL 
IMAGE 


AE 


8 F 


80 


163 


RETURN 


LDX 


SAVREGS+1 


; RESTORE X 


AC 


90 


80 


164 




LDY 


SAVREGS+2 


; RESTORE Y 


AD 


40 


FA 


165 




LDA 


MONIRQ 


; CHECK MONITOR ROM 


C9 


85 




166 




CMP 


#$85 


; DBLTM ROM? 


DO 


03 




167 




BNE 


RETURNl 


; YES 


A5 


45 




168 




LDA 


$45 


; RESTORE ACC FROM 
LOC. $45 


40 






169 




RTI 




; RETURN FROM THE 
INTERRUPT 








170 










AD 


8E 


80 


171 


RETURN 1 


LDA 


SAVREGS 


; RESTORE ACC FROM 
















SAVREGS 


40 






172 




RTI 




; RETURN FROM THE 
















INTERRUPT 








173 
















174 


** ADDRESSES 


OF 1ST BYTE 


OF EACH SCREEN LINE 








175 











51 



8 1 IF : 


00 


80 


00 


176 


ADDRLO 


HEX 


0080008000 






8122: 


80 


00 
















8124: 


80 


00 


80 


177 




HEX 


800080 28 A8 






8127 : 


28 


A8 
















8129 : 


28 


A8 


28 


178 




HEX 


28A828A828 






8 1 2 C : 


A8 


28 
















812E : 


A8 


50 


DO 


179 




HEX 


A850D0 50D0 






8131 : 


50 


DO 
















8133 : 


50 


DO 


50 


180 




HEX 


50D050D0 






8136: 


DO 


















8137 : 


04 


04 


05 


181 


ADDRHI 


HEX 


0404050506 






8 1 3 A : 


05 


06 
















8 1 3 C : 


06 


07 


07 


182 




HEX 


0607070404 






8 1 3 F : 


04 


04 
















8141 : 


05 


05 


06 


183 




HEX 


0505060607 






8144 : 


06 


07 
















8146 : 


07 


04 


04 


184 




HEX 


0704040505 






8149 : 


05 


05 
















814B : 


06 


06 


07 


185 




HEX 


06060707 






814E : 


07 






186 




















187 


* BOUNCE SOUND 














188 












8 1 4 F : 


A2 


OA 




189 


SOUND 


LDX 


#10 


i 


VALUE FOR DURATION 
TONE 


8151 : 


AO 


32 




190 


DLOOP 


LDY 


#50 


) 


VALUE FOR PITCH OF 
TONE 


8153 : 


AD 


30 


CO 


191 




LDA 


SPKR 


» 


CLICK. THE SPEAKER 
ONCE 


8156 : 


88 






192 


PLOOP 


DEY 




$ 


PITCH COUNTER 


8157: 


DO 


FD 




193 




BNE 


PLOOP 


j 


LOOP FOR PITCH 


8159 : 


CA 






194 




DEX 




* 

$ 


DURATION COUNTER 


8 1 5 A : 


DO 


F 5 




195 




BNE 


DLOOP 


> 


LOOP FOR DURATION 


815C: 


60 






196 




RTS 




m 

j 


DONE WITH THE TONE 










197 




















198 


* TEXT 


PLOT, 


SAVING BCKRND 












199 












815D : 


AC 


8D 


80 


200 


PLOT 


LDY 


YP 


3 


GET LINE # TO PLOT 
ON 


8160 : 


B9 


IF 


81 


201 




LDA 


ADDRLO , Y 


3 


GET LO BYTE OF 
ADDRESS 


8163 : 


85 


06 




202 




STA 


PTR 


3 


PUT IN PTR 


8165: 


B9 


37 


81 


203 




LDA 


ADDRHI , Y 


3 


GET HI BYTE OF 
ADDRESS 


8168 : 


85 


07 




204 




STA 


PTR+1 


3 


PUT IN PTR+1 


8 1 6 A : 


AC 


8C 


80 


205 




LDY 


XP 


3 


GET HORIZ. POSN ON 
LINE 


816D: 


AD 


8B 


80 


206 




LDA 


VALUE 


3 


GET VALUE TO PLOT 


8170 : 


91 


06 




207 




STA 


(PTR) , Y 


3 


PUT IT ON THE 
SCREEN 


8172 : 


60 






208 




RTS 




5 


DONE WITH THE PLOT 
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******************************** 
*INTERRUPT DRIVER BOUNCING BALL* 
* 1/21/85 * 

******************************** 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 



8000 : 


A9 


52 




17 


8002 : 


8D 


FE 


03 


18 


8005 : 


A9 


80 




19 


8007 : 


8D 


FF 


03 


20 



21 

22 

23 

24 



80 0 A : 


20 


58 


FC 


25 


8Q0D : 


A9 


FF 




26 


800F : 


8D 


48 


80 


27 


8012 : 


8D 


49 


80 


28 


8015 : 


A9 


14 




29 


8017 : 


8D 


44 


80 


30 


801 A: 


8D 


45 


80 


31 


80 1 D : 


A9 


14 




32 


80 1 F : 


8D 


46 


80 


33 


8022 : 


8D 


47 


80 


34 










35 


8025 : 


A9 


20 




36 


8027 : 


8D 


4A 


80 


37 



IRQ 


EQU 


$ 3 FE 


PTR 


EQU 


$06,07 


MONIRQ 


EQU 


$ F A40 


HOME 


EQU 


$ F C5 8 


SPKR 


EQU 


$ CO 30 




ORG 


$8000 


* SET 


INT. VECTOR 


INIT 


LDA 


# < S T ART 




STA 


IRQ 




LDA 


#>START 




STA 


IRQ+1 



* SET THE BALL DELTA, 

* BALL POSITION 

JSR HOME 

LDA #$FF 

STA XD 

STA YD 

LDA #20 

STA RATE 
STA TIME 
LDA #20 

STA XPOS 

STA YPOS 

DRAW 1 LDA #$2 0 

STA NEWVAL 



; MONITOR HOME 
ROUTINE 



; LO BYTE OF IRQ 
ROUTINE 

; PUT IN LO BYTE OF 
VECTOR 

; HI BYTE OF IRQ 
ROUTINE 

; PUT IN HI BYTE OF 
VECTOR 

TIMER, 



; CLEAR SCREEN AND 
HOME CURSOR 

; #$ FF = -1 IN 2'S 
COMPLEMENT MATH 

; SET X VELOCITY TO 
-1 UNIT 

; SET Y VELOCITY TO 
-1 UNIT 

; # OF INTS PER 

CYCLE 

; SET 'RATE' VALUE 

; SET TIME = RATE 

; STARTING X,Y POSN 
OF BALL 

; X POSITION OF BALL 

= 20 

; Y POSITION OF BALL 
= 20 

; INVERSE BLOCK 

; CHARACTER TO PLOT 



53 



80 2 A : 


AD 


46 


80 


38 




LDA 


XPOS 


> 


NEW X POSITION OF 
BALL 


802D : 


8D 


4D 


80 


39 




STA 


XP 


) 


PUT IN XP FOR PLOT 
ROUTINE 


8030 : 


AD 


47 


80 


40 




LDA 


YPOS 


9 


NEW Y POSITION OF 
BALL 


8033 : 


8D 


4E 


80 


41 




STA 


YP 


9 


PUT IN YP FOR PLOT 
ROUTINE 


8036 : 


20 


23 


81 


42 




JSR 


PLOT 


9 


DRAW THE BALL 
IMAGE 


8039 : 


AD 


4 C 


80 


43 




LDA 


OLDVAL 


9 


GET VALUE OF 
BACKGROUND CHAR 
'UNDER' BALL 


80 3 C : 


8D 


4 B 


80 


44 




STA 


SV 


9 


SAVE IN 'SV' 
LOCATION 










45 




















46 


* ENABLE 


INTS 


. AND ACTIVATE CARD 










47 












80 3 F : 


58 






48 




CL I 




j 


ENABLE INTERRUPTS 


8040 : 


AD 


CO 


CO 


49 




LDA 


$C0C0 


t 


$ CO ( 8+N ) 0 = TURN 
ON CARD 


8043 : 


60 






50 




RTS 




j 


DONE WITH STARTUP! 










51 




















52 


* VARIABLES 
















53 












8044 : 


00 






54 


RATE 


HEX 


00 


> 


it OF INTS PER 
SCREEN CYCLE 


8045 : 


00 






55 


TIME 


HEX 


00 


> 


CURRENT INT it 
COUNTER 


8046 : 


00 






56 


XPOS 


HEX 


00 


> 


X POSN ON SCREEN 
OF BALL (0-39) 


8047 : 


00 






57 


YPOS 


HEX 


00 


> 


Y POSN ON SCREEN 
OF BALL (0-23) 


8048 : 


00 






58 


XD 


HEX 


00 


9 


X VELOCITY OF 
BALL: 










59 


* 






9 


$01 OR $ FF = +1 OR 
__ 1 


8049 : 


00 






60 


YD 


HEX 


00 


9 


X 

Y VELOCITY OF 
BALL: $01 OR $ F F 


804 A : 


00 






61 


NEWVAL 


HEX 


00 


9 


CHARACTER TO 
'PLOT' 


804B : 


00 






62 


SV 


HEX 


00 


9 


SCREEN VALUE 
'UNDER' THE BALL 


804 C : 


00 






63 


OLDVAL 


HEX 


00 


*9 


CHARACTER SAVED BY 
'PLOT' 


8040 : 


00 






64 


XP 


HEX 


00 


9 


X POSN USED BY 
PLOT 


804E : 


00 






65 


YP 


HEX 


00 


9 


Y POSN USED BY 
PLOT 










66 


* 










804F : 


00 






67 


SAVREGS 


HEX 


00 


9 


ACC SAVING 



54 



LOCATION 



8050 : 


00 






68 




HEX 


00 


9 


X-REG SAVING 
LOCATION 


8051 : 


00 






69 




HEX 


00 


1 


Y-REG SAVING 
LOCATION 










70 




















71 


* 


DISABLE INTS. AND SAVE 


REGS 










72 












8052 : 


8D 


4F 


80 


73 


START STA 


SAVREGS 


5 


SAVE ACCUMULATOR 


8055 : 


8E 


50 


80 


74 




STX 


SAVREGS+1 


J 


SAVE X REGISTER 


8058: 


8 C 


51 


80 


75 




STY 


SAVREGS+2 




SAVE Y REGISTER 










76 




















77 


* 


DEC TIMER. 


TIMER TIMED 


OUT? 










78 


* 


IF NOT, RETURN. IF SO, 


RESET 










79 


* 


TIMER & CONT. 














80 












805B : 


CE 


45 


80 


81 




DEC 


TIME 


J 


TIME = TIME - 1 


805E : 


DO 


71 




82 




BNE 


RETURN 


5 


BACK TO FOREGROUND 
IF NOT DONE 


8060 : 


AD 


44 


80 


83 




LDA 


RATE 


5 


GET 'RATE' VALUE 


8063: 


8D 


45 


80 


84 




STA 


TIME 


j 


RESTORE TIME 
COUNTER TO RATE 
VAL 










85 




















86 


* 


RESTORE BACKRND TO SCREEN LOC. 










87 












8066 : 


AD 


4 B 


80 


88 




LDA 


SV 


> 


GET OLD BACKGROUND 
CHARACTER 


8069 : 


8D 


4 A 


80 


89 




STA 


NEWVAL 


> 


PUT IN CHARACTER 
TO 'PLOT' 


806C: 


AD 


46 


80 


90 




LDA 


XPOS 


9 


CURRENT X POSITION 
OF BALL 


80 6 F : 


8D 


4D 


80 


91 




STA 


XP 


9 


SET XP FOR PLOT 
ROUTINE 


80 72: 


AD 


47 


80 


92 




LDA 


YPOS 


9 


CURRENT Y POSITION 
OF BALL 


8075 : 


8D 


4 E 


80 


93 




STA 


YP 


9 


SET YP FOR PLOT 
ROUTINE 


8078 : 


20 


23 


81 


94 




JSR 


PLOT 


i 


ERASE OLD BALL 










95 




















96 


* 


ADD DELTAS 


TO BALL POSITION 










97 


* 


CHECK FOR BOUNDARIES. 


IF 


HIT, 










98 


* 


REVERSE DIRECTION. 














99 












807B : 


AD 


46 


80 


100 


NEWX LDA 


XPOS 


9 


GET CURRENT X POSN 




















OF BALL 


807E : 


18 






101 




CLC 




9 


CLEAR CARRY BIT 
FOR AN ADD 


80 7 F : 


6D 


48 


80 


102 




ADC 


XD 


9 


ADD X VELOCITY 



VALUE 



55 



8082 : 


30 


OA 




103 




BMI 


RVRSX 


; IF AT LEFT SIDE OF 
SCREEN (X<0) 


8084 : 


C9 


27 




104 




CMP 


#39 


; AT RIGHT SIDE OF 
SCREEN? 


8086: 


FO 


06 




105 




BEQ 


RVRSX 


; YES 


8088 : 


8D 


46 


80 


106 




STA 


XPOS 


; STORE NEW X 

POSITION OF BALL 


8 08B : 


4 C 


99 


80 


107 




JMP 


NEWY 


; CALCULATE NEW Y 
POSITION 


808E : 


AD 


48 


80 


108 


RVRSX 


LDA 


XD 


; GET CURRENT X 
VELOCITY 


8091 : 


49 


FE 




109 




EOR 


#$FE 


; XD = XD * -1 TO 
REVERSE MOTION 


8093 : 


8D 


48 


80 


110 




STA 


XD 


; STORE NEW X 
VELOCITY 


8096 : 


20 


15 


81 


111 




J SR 


SOUND 


; MAKE A 'BOUNCE" 
NOISE 










112 










8099 : 


AD 


47 


80 


113 


NEWY 


LDA 


YPOS 


; GET CURRENT Y 
POSITION OF BALL 


809 C : 


18 






114 




CLC 




; CLEAR CARRY BIT 
FOR AN ADD 


809D : 


6D 


49 


80 


115 




ADC 


YD 


; ADD Y VELOCITY 


80A0 ; 


30 


OA 




116 




BMI 


RVRSY 


; IF AT TOP OF 
SCREEN ( Y<0 ) 


80A2 : 


C9 


17 




117 




CMP 


#2 3 


; AT BOTTOM OF 
SCREEN ( Y = 2 3 ? ) 


80A4 : 


FO 


06 




118 




BEQ 


RVRSY 


; YES 


80 A6 : 


8D 


47 


80 


119 




STA 


YPOS 


; STORE NEW Y 

POSITION OF BALL 


80A9 : 


4C 


B 7 


80 


120 




JMP 


DRAW 


; DRAW THE NEW BALL 
IMAGE 










121 










80 AC : 


AD 


49 


80 


122 


RVRSY 


LDA 


YD 


; GET CURRENT Y 
VELOCITY 


80AF : 


49 


FE 




123 




EOR 


#$ FE 


; YD = YD * -1 TO 
REVERSE MOTION 


80B I : 


8D 


49 


80 


124 




STA 


YD 


; STORE NEW Y 
VELOCITY 


80B4 : 


20 


15 


81 


125 




JSR 


SOUND 


; MAKE A 'BOUNCE' 
NOISE 










126 


















127 


* DRAW 


BALL AT XP,YP AND SAVE 










128 


* THE 


BACKROUND IN SV 












129 










80 B 7 : 


A9 


20 




130 


DRAW 


LDA 


#$20 


; INVERSE BLOCK 


SOB 9 : 


8D 


4 A 


80 


131 




STA 


NEW VAL 


; CHARACTER TO PLOT 


80 B C : 


AD 


46 


80 


132 




LDA 


XPOS 


; NEW X POSITION OF 


















BALL 


80BF : 


8D 


4D 


80 


133 




STA 


XP 


; PUT IN XP FOR PLOT 



ROUTINE 



56 



80C2 : 


AD 


47 


80 


134 




LDA 


YPOS 


9 


NEW Y POSITION OF 
BALL 


80C5 : 


8D 


4E 


80 


135 




STA 


YP 


9 


PUT IN YP FOR PLOT 
ROUTINE 


8 0C8 : 


20 


23 


81 


136 




JSR 


PLOT 


J 


DRAW THE BALL 
IMAGE 


8 OCB : 


AD 


4 C 


80 


137 




LDA 


OLDVAL 


9 


GET VALUE OF 
B ACKGRND CHAR 
'UNDER' BALL 


80 CE : 


8 D 


4B 


80 


138 




STA 


SV 


9 


SAVE IN 'SV' 
LOCATION 










139 




















140 


* RESTORE REGS AND RETURN 














141 












SOD 1 : 


AE 


50 


80 


142 


RETURN 


LDX 


SAVREGS+1 


m 

9 


RESTORE X REGISTER 


8QD4 : 


AC 


51 


80 


143 




LDY 


SAVREGS+2 


9 


RESTORE Y REGISTER 


80D7 ; 


AD 


40 


FA 


144 




LDA 


MON IRQ 


9 


CHECK MONITOR ROM 


80DA ; 


C9 


85 




145 




CMP 


#$85 


9 


DBLTM ROM? 


80DC ; 


DO 


03 




14 6 




BNE 


RETURN1 


9 


YES 


80DE : 


A5 


45 




147 




LDA 


$45 


9 


RESTORE ACC FROM 
LOCATION $45 


80E0 : 


40 






148 




RTI 




3 


RETURN FROM THE 
INTERRUPT 


80EL : 


AD 


4 F 


80 


149 


RETURN 1 


LDA 


SAVREGS 


J 


RESTORE ACC FROM 
SAVREGS 


80E4 : 


40 






150 




RTI 




9 


RETURN FROM THE 
INTERRUPT 










151 




















152 


** ADDRESSES 


OF 1ST BYTE 


OF EACH SCREEN LINE 










153 












80E5 : 


00 


80 


00 


154 


ADDRLO 


HEX 


0080008000 






80E8 : 


80 


00 
















80E A : 


80 


00 


80 


155 




HEX 


8 0008028 A8 






80ED: 


28 


A8 
















80EF : 


28 


A8 


28 


156 




HEX 


28 A828A828 






80F2 : 


A8 


28 
















80F4 : 


A8 


50 


DO 


157 




HEX 


A850D050D0 






80F7 : 


50 


DO 
















80F9 : 


50 


DO 


50 


158 




HEX 


50D050D0 






80FC : 


DO 


















80FD : 


04 


04 


05 


159 


ADDRHI 


HEX 


0404050506 






8100 : 


05 


06 
















8102 : 


06 


07 


07 


160 




HEX 


0607070404 






8105 : 


04 


04 
















8107 : 


05 


05 


06 


161 




HEX 


0505060607 






8 1 0 A : 


06 


07 
















8 IOC : 


07 


04 


04 


162 




HEX 


0704040505 






8 10F : 


05 


05 
















Sill : 


06 


06 


07 


163 




HEX 


06060707 






8114; 


07 
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164 












8115 : 


A2 


OA 




165 


SOUND 


LDX 


#10 


1 


VALUE FOR DURATION 
OF TONE 


8117: 


AO 


32 




166 


DLOOP 


LDY 


#50 


J 


VALUE FOR PITCH OF 
TONE 


8119 : 


AD 


30 


CO 


167 




LDA 


SPKR 


5 


CLICK THE SPEAKER 
ONCE 


81 1C : 


88 






168 


PLOOP 


DEY 




J 


Y - Y - 1 


8 1 ID : 


DO 


FD 




169 




BNE 


PLOOP 


5 


PITCH LOOP 


81 IF : 


CA 






170 




DEX 




I 


X = X - 1 


8120 : 


DO 


F 5 




171 




BNE 


DLOOP 


3 


DURATION LOOP 


8122 : 


60 






172 




RTS 




J 


DONE WITH THE 
BOUNCE NOISE 










173 




















174 


** PTR 


PLOT SAVING BACKRND 














175 












8123 : 


AC 


4 E 


80 


176 


PLOT 


LDY 


YP 


9 


GET Y COORDINATE 




















TO PLOT AT 


8126 : 


B9 


E 5 


80 


177 




LDA 


ADDRLO , Y 


9 


GET LO BYTE OF 
AD DR FROM TABLE 


8129 : 


85 


06 




178 




STA 


PTR 


9 


PTR = LO BYTE 


8 1 2 B : 


B 9 


FD 


80 


179 




LDA 


ADDRHI , Y 


9 


GET HI BYTE FROM 
TABLE 


812E : 


85 


07 




180 




STA 


PTR+1 


9 


PTR+1 = HI BYTE 


8130 : 


AC 


4D 


80 


181 




LDY 


XP 


9 


GET X COORDINATE 
TO PLOT AT 


8133: 


B 1 


06 




182 




LDA 


(PTR) ,Y 


9 


GET CHARACTER 
THERE NOW 


8135 : 


8D 


4C 


80 


183 




STA 


OLDVAL 


9 


SAVE IN 'OLDVAL' 


8138 : 


AD 


4 A 


80 


184 




LDA 


NEWVAL 


9 


SET ACC TO VALUE 
TO PLOT 


813B : 


91 


06 




185 




STA 


(PTR) ,Y 


9 


PUT IT ON THE 
SCREEN 


8 1 3D : 


60 






186 




RTS 




9 


DONE WITH THE PLOT 
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INTERRUPT SUMMARY CARD 



To turn on interrupts: 

1) Set up the vector at $3FE,3FF to point to your 
interrupt routine. 

2) Enable interrupts with the CLI instruction. 

3) Turn on the Interrupt Source Card by accessing a 
memory location in the range $C0(8+N)0 to $C0(8+N)F. 

( $ CO CO for Slot #4 for example). 

Method #2: 

If you have used the Workbench, or have BLOADed the 
IRQON.TB routine, just call it with the syntax: 

& ” IRQON" , ADDR or CALL LOC, ADDR 

Where LOC is the address of the IRQON.TB routine and 
ADDR is the address of the interrupt routine. If the 
interrupt vector is already set up, interrupts can be 
re-enabled by omitting the comma and the address 
variable from the command. 

To turn off interrupts: 

1) Execute the SEI instruction from machine language. 

2) Turn off the Interrupt Source Card by accessing any 
location in the range $C(N)00 to $C(N)FF. 

($C400 for example for slot #4). 

Method #2: 

If you have the Workbench, or have BLOADed the IRQOFF.TB 
routine, just call it with the syntax: 

& " IRQ OFF" or CALL LOC 

Where LOC Is the address of the IRQOFF.TB routine. 




i 















